痛点

在使用 git worktree + 多个 agent 开发 Rust 项目时，Cargo 的默认行为会让所有构建共享同一个全局目录：

target/
.cargo/.package-cache
registry cache
target/.cargo-lock

这会导致几个严重问题：

• 多个 worktree 同时构建会互相覆盖 target/
• CI 多 agent 并发构建会争抢 .cargo-lock
• 增量编译缓存被污染，构建结果不稳定
• 本地与 CI 行为不一致，debug 成本高

换句话说：

Rust 项目一旦进入 multi-worktree / multi-agent 模式，Cargo 默认的 target 目录就会成为的瓶颈。

解决方案：cargo‑worktree

我们发布了 cargo‑worktree，为每个 worktree 自动分配独立的构建目录：

target/git/<namespace(branch/rev)>/

特点：

• 每个 worktree 独立 target → 不再互相覆盖
• 并发构建安全 → 不会再争抢 .cargo-lock
• 增量编译缓存稳定 → 不会被其他分支污染
• 零侵入 Cargo → 仍然是 cargo build 的体验

crate: https://crates.io/crates/cargo-worktree/1.0.0

安装：

cargo install cargo-worktree

使用：

cargo worktree build
cargo worktree test
cargo worktree run

demo

欢迎大家使用和反馈