吾倦于每新立 Rust 之项目,必设同物。Clippy 之配置,CI 之管道,链接之标志,预提交之钩,cargo-nextest,皆须从始,每回如是。复每易 AI 编码之器,又须为之复始,重释项目之结构,Lint 之规则,何者不可越。
是故,吾构 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— 钩子于本地运行,非仅限持续集成
其旨乃使尔无需忆及此举。自当如是.
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,皆遵同律,无庸更习。
若依此範本啟新工,亦可直授倉庫之址於使為境:
"以github.com/d-oit/rust-2026-template為此工之參。"
其能自取结构,择工具,循惯例,无需君一言提示之.
性能默认值君或忘加
.cargo/config.toml立mold链接器。一行代码,增量构建显著提速。开发者模式调校以避“吾之调试构建永无休”之患。细事耳,然经半载于项目,君必察之。
之用
- 击"用此模板"于GitHub — 或告尔之代理:以
github.com/d-oit/rust-2026-template为是项目之参照 - 随
QUICKSTART.md— 更易诸匣之名,更新Cargo.toml - 于本地行
./scripts/quality-gates.sh
依MIT許可。歡迎貢獻——若君常於Rust項目中添某常規,請開啟議題.











