什么时候值得使用 worktree
任务需要长时间运行、存在多个互不依赖的修改方向，或希望主工作区保持干净时，worktree 很合适。一次只改一个小文件的任务通常没必要增加管理成本。使用前应确认项目是 Git 仓库，并且关键状态都在版本控制或可重复生成的环境中。
为每个任务建立清晰边界
一个 worktree 对应一个明确任务和一组预期验证。创建后先读取仓库规则、安装必要依赖并检查初始测试状态，再让 Codex 修改。不要让两个 worktree 同时修改同一逻辑却没有合并顺序，否则隔离只能推迟冲突，不能消除冲突。
- 任务名称与目录名称保持可识别
- 开始前记录基线分支和提交
- 每个目录单独运行依赖安装与环境初始化
- 完成后保留测试结果和变更摘要
理解分离 HEAD 与分支占用限制
worktree 可能从分离 HEAD 状态开始；如果要保留并提交工作，应创建一个明确分支。同一个本地分支通常不能同时检出到多个 worktree，因此合并或切换前要先确认分支当前被哪个目录使用。
把分支创建、提交和合并作为显式步骤，能避免工作已经完成却只存在于难以识别的临时状态。提交前仍需检查差异，不要把缓存、密钥或本地环境文件带入分支。
处理未跟踪文件与环境差异
Git 只会为受版本控制的文件提供一致基线。未跟踪的环境模板、开发证书或本地工具如果是任务必需，应通过安全的初始化脚本生成，或使用项目允许的 worktree 包含机制。真实密钥不应复制进仓库，也不应由 Codex 写入提交。
完成后的回收与合并清单
先在任务 worktree 中完成测试、构建和差异审查，再提交到专用分支。回到集成分支合并后重新运行受影响测试，确认合并环境没有遗漏。只有在改动已经安全保存且不再需要调查现场时，才移除 worktree。
- 确认工作区无遗漏改动
- 把成果保存在可识别分支或提交中
- 在集成分支重新验证
- 删除不再使用的 worktree 与临时依赖
官方资料与延伸阅读
本文按官方公开资料重新组织为中文实践指南。产品界面和能力可能调整，具体以官方页面为准。
相关主题与下一步阅读
ChatGPT Plus、ChatGPT Pro、Codex 与 OpenAI API 属于不同产品或使用入口。围绕充值、支付和到账问题，建议继续阅读对应专题，避免把会员方案、开发接口余额和编码工具混为一谈。
常见问题
worktree 和复制整个仓库有什么区别？＋
worktree 共享同一个仓库的 Git 对象与引用，目录更轻量，也能清晰展示各工作区状态；完整复制则是相互独立的仓库。
两个 worktree 可以使用同一个分支吗？＋
通常不能同时检出同一个本地分支。建议每个并行任务使用独立分支，再按计划合并。
删除 worktree 会不会丢失代码？＋
如果未提交或未备份的改动仍在其中，删除可能造成损失。移除前必须检查状态，并把需要的成果保存到分支或提交。