多个 Agent 在同一工作目录同时改文件会覆盖彼此。Worktree 给每个任务独立检出、依赖和变更，适合比较方案或隔离高风险重构。
开始前先准备什么
先让主工作区保持干净，确认仓库支持 Git worktree，并准备不会共享生产数据的安装与测试流程。
先运行 git status --short和 git worktree list，记录主分支与已有工作树。每个任务应有独立目标，例如“修复登录测试”与“比较缓存方案”，不要让两个 Agent 同时负责同一文件或同一数据库迁移。
实际操作步骤
- 在 Agents Window 为任务选择 worktree，或在 IDE 使用 /worktree；给每个 Agent 不重叠的目标。
- 如需自动安装依赖，在 .cursor/worktrees.json 写可重复且无破坏性的 setup 命令。
- 每个 Agent 完成后分别阅读 diff、运行测试并记录优缺点，不能只选最快结果。
- 选择一个结果提交或用 /apply-worktree 带回主工作区；再次解决冲突和运行回归测试。
Cursor Worktrees 官方文档说明，Agents Window 的原生工作树会为任务创建独立检出；在 IDE 可使用 /worktree，完成后可用 /apply-worktree带回结果，或用 /delete-worktree清理。应用或删除之前都应检查有用改动是否已提交或保存。
配置可重复的初始化
Cursor 会读取 .cursor/worktrees.json。它支持通用 setup-worktree以及 Unix、Windows 专用键；值可以是顺序命令数组或相对于该配置文件的脚本路径。一个 Node.js 示例：
{
"setup-worktree": [
"npm ci",
"npm test -- --runInBand"
]
}初始化必须可重复且无破坏性。不要无条件执行生产迁移、写共享缓存或连接生产数据库。官方文档不建议把依赖目录软链接进工作树，因为会影响主工作树；应让每个检出有自己的依赖环境。需要环境变量时使用专门的测试值，并避免把密钥提交进仓库。
用同一验收表比较候选
给每个 Agent 相同输入、测试命令和限制，完成后记录：改动文件数、核心设计、测试结果、已知限制和迁移影响。可以要求：
在隔离 worktree 中修复 auth 测试。只改 src/auth 与 tests/auth。
先说明失败原因，再实现最小修复；运行仓库现有相关测试，
最后给出 git diff --stat、测试命令、结果和仍未覆盖的边界。选择结果时逐个阅读 diff，并在各自工作树运行同一测试。速度不是唯一标准；要比较正确性、改动范围、维护成本和回退难度。
带回主工作区后的验证
应用结果前让主工作区保持干净。带回后检查冲突、最终差异和依赖文件，再运行完整相关测试。Cursor Agents Window 官方文档是界面和 Agent 管理入口的依据；无论使用界面还是 Git 命令，最终都以主工作区中的提交与测试证据为准。
怎样验证结果
通过标准是每个工作树改动独立、测试记录可比较、主工作区未被污染，合并后完整相关测试通过。
若一个工作树的端口、容器名或本地数据库与另一个冲突，应为每个任务分配独立资源后重测。删除前再次运行 git status --short，确认没有未带回的有用文件。
常见错误
- 不要在 setup 中无条件执行生产迁移。
- 不要把依赖目录用不安全软链接共享。
- 删除工作树前确认有用改动已提交或带回。
适用边界
数据库迁移、固定端口和共享缓存可能仍相互影响；并行前要隔离外部资源。
相关问答
Worktree 和新分支有什么区别？
Worktree 是独立工作目录并关联分支，让多个任务能同时存在。
如何查看现有工作树？
可运行 git worktree list，并在 Cursor 的工作树界面核对。
资料与适用范围
本文根据 2026 年 10 月 1 日核验的 Cursor Worktrees 官方文档、Cursor Agents Window 官方文档整理。示例流程未在你的设备、账号或仓库中实测，界面、方案、权限和项目命令应以当前环境为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32676.html
