From 6672acf42c265b26302e67a7e8d3d225612784a7 Mon Sep 17 00:00:00 2001
From: t8y2 <1156263951@qq.com>
Date: Mon, 15 Jun 2026 18:52:18 +0800
Subject: [PATCH] docs: add optional build speed-up hints to cargo config

---
 .cargo/config.toml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/.cargo/config.toml b/.cargo/config.toml
index 398b7f9d6..c7ddd216a 100644
--- a/.cargo/config.toml
+++ b/.cargo/config.toml
@@ -1,3 +1,18 @@
+# === Optional build speed-ups (add to your ~/.zshrc or ~/.bashrc; do NOT commit) ===
+#
+# 1. sccache — compile cache, skips recompiling unchanged deps
+#    cargo install sccache
+#    export RUSTC_WRAPPER=sccache
+#
+# 2. lld — LLVM linker, 2-3x faster linking than the system default
+#    macOS:  brew install lld
+#            export CARGO_TARGET_AARCH64_APPLE_DARWIN_LINKER=/opt/homebrew/bin/lld
+#    Linux:  apt install lld
+#            export CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER=lld
+#
+# Skip DuckDB during development: cargo check --no-default-features
+# ===================================================================================
+
 [env]
 # Enable SQLite's built-in math functions for rusqlite's bundled libsqlite3.
 LIBSQLITE3_FLAGS = "SQLITE_ENABLE_MATH_FUNCTIONS"