Codex工作树模式解析：创建平行副本防污染指南【技巧】

日常开发中，最让人头疼的场景之一，就是正在本地吭哧吭哧写一个功能分支，结果团队临时丢过来一个紧急 bug 要修。如果直接在同一个目录下操作，文件修改会搅在一起，diff 乱成一锅粥，本地还没提交的改动也面临被覆盖的风险。工作树模式本质上就是一套隔离机制，专门用来化解这类并行任务带来的死锁问题。

确认项目已初始化为Git仓库

任何隔离操作的前提，是项目得先有一个 Git 仓库。打开终端，切到你的项目根目录，跑一下 git status。如果返回的是 “fatal: not a git repository”，说明还没初始化。

这时候得手动走完一套初始化流程：git init → git add . → git commit -m "init"。否则 Codex 根本没法创建 Worktree，而且它不会给任何提示——选项直接灰掉，你得自己排查。

在Codex App中启用工作树模式

方法一：新建线程时启用

点击左上角的 “+ New Thread”，在输入框下方找到 “Run in” 下拉菜单，选择 “Worktree”。接着点击右侧的分支选择器，挑一个干净的基础分支（推荐 main 或者当前稳定的 feature 分支），然后正常输入你的任务描述，比如 “修复登录页 404 错误”。

方法二：已有线程切换至工作树

如果你已经开了一个线程，中途想切到隔离环境，可以在线程右上角点击 “⋯” → 选择 “Handoff to Worktree” → 确认目标分支。Codex 会自动创建一个新工作树，并把当前会话的上下文完整迁移过去。

切记：Handoff 之后，原线程依然在 Local 模式下保留，但此后所有的代码修改、命令执行都会跑在新工作树里，文件系统完全隔离，互不干扰。

验证工作树是否生效

验证步骤其实很简单，分四步走：

第一步：打开终端，cd 到你的项目根目录。
第二步：执行 git worktree list。
第三步：看输出里有没有类似这样的条目：/path/to/project/worktrees/xxx-hash abc1234 [main]。其中 worktrees/xxx-hash 是 Codex 自动生成的子目录名，[main] 表示它基于哪个分支。
第四步：进入这个路径，运行 ls -la。你会看到完整的项目文件，而且 .git 不是一个独立仓库，而是一个指向主仓库 .git/worktrees/xxx-hash 的文件。这就是隔离性的直观证据——你在工作树里删掉 src/App.tsx，Local 目录下的同名文件毫发无损。

安全退出与清理工作树

任务完成且确认不需要保留改动之后，在 Codex 线程界面点击右上角 “⋯” → 选择 “Remove Worktree”。

Codex 会自动执行 git worktree remove /path/to/worktree，干净利落地删除整个工作树目录和对应的元数据。

这里有个坑需要提一下：如果手欠直接 rm -rf 删掉工作树目录，git worktree list 里会残留一条记录。下次再创建新的工作树时，可能会报错 “invalid reference”。解决办法是手动跑一下 git worktree prune，把那些“僵尸”引用清理干净。