我厭倦了每次新的 Rust 專案都要設定相同的事情。Clippy 設定檔、CI 管道、鏈接器旗標、pre-commit 鈎子，cargo-nextest... 每次都從頭開始。然後每次我切換 AI 編碼工具時都要再做一次，重新解釋專案結構、靜態分析規則、什麼是不被允許的。
所以我就建立了rust-2026-template。點擊「使用此範本」，將您的代理指向它，您就開始編碼了——而不是進行設定.
這裡是實際包含的内容.
我最終總是得到這樣的設定
Rust 2024 版本，MSRV 1.87 通過 rust-toolchain.toml 固定。從第一天開始就有工作空間佈局——即使對於小型專案。後來將單一組件專案重构為工作空間只會帶來不必要的痛苦：
crates/
example-crate/
sample-app/
重新命名這些，完成
一個腳本，完整品質門檻
./scripts/quality-gates.sh
這執行 fmt， clippy (嚴謹，零警告)， cargo nextest， cargo audit， cargo deny，以及選擇性cargo mutants。相同的事情 CI 會執行。我會在每次提交前執行它，所以沒有驚喜。
使用 cargo-mutants 進行變異測試是我會推薦人們嘗試的——它告訴你你的測試是否真的 抓到錯誤，還是僅僅 觸及程式碼。非常不同的事情。
安全預設，不是後果
-
deny.toml— 授權政策及禁止的倉庫 -
.gitleaks.toml— 在任何提交之前進行機密掃描 -
.pre-commit-config.yaml— 錨頭在本地執行，不僅僅是在 CI 中
目標是讓你永遠不必記得要做這件事。它只是自動發生.
AI 代理開箱即用
這是目前我最常用的部分。每個 AI 編碼工具都需要專案背景資訊——而且它們都希望這些資訊放在稍微不同的位置。而不是每次會話都要重新解釋規範，所有這些都已經檢查進入：
.agents/ — skill definitions per agent
.claude/ — Claude Code config
.cursor/ — Cursor rules
.gemini/ — Gemini CLI config
.opencode/ — OpenCode config
.qwen/ — Qwen CLI config
.windsurf/ — Windsurf config
AGENTS.md — canonical project rules, read by every agent
llms.txt — machine-readable project overview
AGENTS.md 是關鍵文件。它告訴任何代理：工作空間佈局、靜態代碼分析規則、提交約定、什麼不應該觸碰。你在專案中從 Claude Code 切換到 Codex 再到 OpenCode — 他們都讀取相同的規則。無需重新認知。
當你從這個模板開始一個新專案時，你也可以直接把倉庫 URL 作為背景資訊交給你的代理：
"以 github.com/d-oit/rust-2026-template 作為此專案的參考。"
它會自動識別結構、工具選擇和慣例，而無需你為它們寫一個提示
你忘記添加的性能預設
.cargo/config.toml 設置了 mold �鏈接器。僅需一行代碼，顯著提升增量編譯速度。開發者配置文件已調整以避免「我的調試構建永無止境」的問題。這是個小細節，但在項目開發六個月後你會注意到它。
使用它
- 點擊 "使用此範本" 在 GitHub — 或者告訴你的代理：將
github.com/d-oit/rust-2026-template作為此專案的參考 -
追蹤
QUICKSTART.md— 重新命名 the crates，更新Cargo.toml -
執行
./scripts/quality-gates.sh在本地一次
MIT 授權。歡迎貢獻 — 如果您總是在 Rust 專案中添加某個模式，請開啟一個問題。