cursor的环境模式：Worktree

选择 Worktree 模式后，Cursor 会自动利用 Git worktree 为每个 Parallel Agent（并行代理）创建一个独立的隔离工作目录和分支。这允许多个 Agent 同时运行而不互相冲突，非常适合实验不同实现方案、拆分复杂任务或运行相同 prompt 在多个模型上。

上手操作步骤

1. 启动 Parallel Agents：

   • 在 Agent 或 Composer 界面中，输入你的任务 prompt。

   • 点击启动多个代理（例如 4x 或 8x 并行，通常有按钮如 “Run 4 agents” 或类似）。

   • 选择 Worktree 作为运行环境（如果你已经在下拉菜单中选了，它会默认使用）。

   • Cursor 会自动：

     • 为每个 Agent 创建一个新分支（通常命名如 agent-1、agent-2 等）。

     • 在项目同级目录（sibling folder，如 ../your-project-agent-1）创建对应的 worktree 目录。

     • 在每个隔离的 worktree 中独立运行 Agent。

2. 监控和交互：

   • Cursor 主界面会显示多个 Agent 的进度（并行运行，每个有自己的聊天/执行流）。

   • 你可以切换 tab 查看每个 Agent 的输出、diff 或日志。

   • Agent 完成后，每个 worktree 会生成独立的更改（commits 或 unstaged changes）。

3. 应用更改：

   • 查看每个 Agent 的结果（通常有聚合 diff 视图）。

   • 选择你喜欢的方案：点击 Apply 或类似按钮，将该 worktree 的更改合并到你的主分支/当前工作区。

   • 或者手动：切换到主目录，使用 git merge <branch-name> 合并对应分支。

   • 应用后，Cursor 会自动清理临时 worktree（或你可以手动删除）。

4. 自定义（可选）：

   • 在项目根目录创建 .cursor/worktrees.json 文件，可以配置 worktree 的路径、分支命名等（参考官方文档或社区示例）。

   • 如果想手动管理：用终端命令 git worktree list 查看所有 worktree，git worktree remove <path> 删除。

需要注意的事项

• 项目必须是 Git 仓库：Worktree 依赖 Git 初始化（git init）。如果不是，Cursor 可能会提示或 fallback 到其他模式。

• 磁盘空间和性能：Worktree 共享 Git 对象（比完整 clone 省空间），但多个并行 Agent 会占用更多 CPU/内存。建议从 2-4 个开始测试，不要一下开 8 个。

• 分支管理：每个 Agent 创建新分支，保持主分支干净。完成后及时合并或删除分支，避免分支堆积。

• 冲突处理：虽然隔离了，但最终合并到主分支时可能有冲突。总是仔细 review diff，手动解决。

• Sandbox 和权限：默认开启 sandbox，Agent 修改文件时可能需要确认（尤其在 worktree 中）。保持开启以防意外大范围修改。

• 清理：任务结束后，用 git worktree prune 清理无效元数据，或手动删除 sibling 目录。不要让 worktree 无限积累。

• 最佳实践：

  • 用于探索多种方案（同一个 prompt 跑多个 Agent，选择最佳）。

  • 或拆分任务（手动为每个 Agent 分配子任务）。

  • 结合规则文件（如 .cursor/rules）指导 Agent 行为。

  • 如果任务简单，单 Agent + Local 模式更快；Worktree 适合复杂/并行场景。

这个模式是 Cursor 2.0+ 的核心并行功能，极大提升效率。第一次用时从简单任务练手，熟悉后会成为日常 workflow。如果你遇到具体问题（如 apply 按钮不见），检查 Cursor 版本更新或查看官方 changelog。