25 · Worktrees 并行隔离指南

Git Worktree 在 Codex 并行任务中的作用、创建和合并流程，以及避免文件覆盖与分支混乱的方法。

当你想让 Codex 同时干几件事，又怕它们互相干扰时，Worktree 是一个优雅的解法。

「Worktree」是 Git 的一个能力：同一个仓库，你可以同时「签出」多个工作目录，每个目录对应一个独立的分支。这样几个任务就能各占一个目录、各干各的，互不踩脚。

在 Codex 场景里，它的典型用法是：主目录保持你当前稳定的状态，再为「交给 Codex 的任务」单独开一个 worktree 和分支，让它在那个隔离的目录里干活。干完了、审查通过了，再合并回主线。

「创建」worktree 用 Git 命令就能完成，核心是「从当前状态拉出一个新的独立工作目录」。每个 worktree 有自己独立的分支，改动互不相通。

「合并」是收尾动作：Codex 在那个 worktree 里改完、你审查满意后，把那个分支合并回主分支，然后清理掉这个 worktree。

「避免混乱」的关键是「纪律」：每个任务一个 worktree、一个分支，别多个任务挤在同一个目录里。改完即合、合完即清，别留着僵尸 worktree。

这套方法的价值，在于「并行」和「隔离」兼得：你可以同时派好几个任务给 Codex，它们各自在独立目录里跑，而你的主线始终是干净、可回退的。

如果你的工作里经常要「同时推进好几件事」，或者「想放心地把任务交给 Codex 又怕它弄乱主线」，那这一篇值得你反复用。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。