结论先说
- 发现改错分支时,第一条铁律是停手别敲
git reset --hard。只要还没覆盖文件,无论改动处于未暂存、已暂存还是已本地提交状态,都可以 100% 无损搬家到正确分支。 - 未提交改动搬家分两种情况:要新建分支直接执行
git switch -c feat/xxx,所有修改与新文件会原地跟随;要搬去已有分支,则必须用git stash push -u(切记带-u把 Codex 新建的未跟踪文件一起装进去),切过去再git stash pop。 - 已在错分支本地
commit过,先「保底建分支」再「还原错分支」。先在当前提交上打一个新分支指针git branch feat/xxx,确认指向无误后,再把本地main重置回origin/main。 - 清理残留孤儿 Worktree 必须走 Git 命令而非裸删文件夹(本站建议)。先用
git worktree list核查每个工作树里是否有未提交成果,再用git worktree remove正常解绑;已经手动删掉目录的,用git worktree prune -v清理失效锁记录。 - 多分支并行交给 Codex 开发非常高效,但也需要更稳的额度支撑。同时跑多个重构线程或频繁代码审查的开发者,可按需在本站开通 ChatGPT Plus 或高配额 ChatGPT Pro,多人研发团队可查看 ChatGPT Business 团队定制。

图:本站根据 Git 官方 git-worktree 文档 与日常排障经验整理的示意图
本文根据 Git 官方git-worktree与git-stash文档、OpenAI Codex 多会话工作流文档及工程抢救实践整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 让 Codex 一口气改完十几个文件,准备提 PR 时才发现自己还停留在
main或上一个未合并分支的开发者; - 使用 Codex 桌面端或 CLI 并行任务(Worktree 模式)后,发现本地多出一堆临时目录,或者切分支报
is already used by worktree被锁住的用户; - 担心乱敲 Git 回滚命令把 Codex 刚写好的新文件和补丁彻底清零的人。
一、改错分支的 3 种场景与无损迁移命令
开始任何迁移前,先在仓库根目录跑一遍状态盘点:
bash
git status -sb
git branch --show-current
git log -n 3 --oneline
确认当前分支名、是否有未跟踪(??)新文件、以及 Codex 是否已经顺手做了 commit 后,按对应场景对号入座:

图:本站根据 Git 分支安全迁移与 Worktree 回收流程整理的示意图
场景 1:改在 main 上,尚未 commit,准备新建一个功能分支
这是最轻松的情况,一行命令即可无损带走全部修改与新文件,原 main 保持完全干净:
bash
git switch -c feat/checkout-retry
git status -sb
场景 2:改在错分支 A,尚未 commit,需要搬进已经存在的分支 B
先用带 -u(--include-untracked)的 stash 把所有变更打包,避免 Codex 新建的组件或测试文件被遗留在错分支上:
bash
# 1. 连同未跟踪文件一起暂存
git stash push -u -m "migrate-codex-changes"
# 2. 切到正确的已有分支并恢复
git switch feat/existing-branch
git stash pop
如果 git stash pop 遇到少量冲突,Git 不会自动删掉这条 stash 记录;解完冲突核对无误后再手动 git stash drop 即可。如果改动方向本身就错了想直接撤回,请改看 /guides/codex-undo-bad-changes-rewind-git-diff-rollback-guide。
场景 3:Codex 已经在本地 main 上做了 1 至 2 次 commit(尚未 push)
绝对不要先回退 main,必须先建新分支把提交指针牢牢抓住:
bash
# 1. 在当前位置新建功能分支,锁住刚才的所有提交
git branch feat/checkout-retry
# 2. 再次核对工作区没有未提交改动后,把本地 main 还原到远端一致
git status --short
git reset --hard origin/main
# 3. 切回刚刚保底建好的功能分支继续开发
git switch feat/checkout-retry
如果你只想把其中某 1 个提交搬到另一个已有分支,则在目标分支运行 git cherry-pick <commit-hash>,核验通过后再回到错分支清理多余提交。
排障与订阅提示:使用 Codex 桌面端或 CLI 并行开多条线程改不同分支时,连续推理对周期额度消耗较快。如果 Plus 额度经常在一天中途告急,可在本站升级 ChatGPT Pro 充值 或 ChatGPT Pro 5x 档位;若新账号卡在手机验证环节,也可参考 Codex 注册手机验证服务。
二、安全抢救并清理残留的孤儿 Worktree
Codex 桌面端与新版 CLI 支持自动创建独立 Git Worktree 隔离并行会话。但如果中途崩溃、异常退出,或者你直接把临时目录拖进了回收站,就常会出现两个问题:磁盘留着一堆旧目录,或者切分支时报错 fatal: '<branch>' is already used by worktree at '...'。
按以下 3 步安全清理(本站建议):
1. 盘点全部工作树并抢救未提交代码
bash
# 列出所有 worktree 路径、当前提交与绑定的分支(失效目录会标 prunable)
git worktree list --porcelain
# 逐个检查仍存在的废弃目录里有没有尚未保存的代码
git -C "/path/to/old-worktree" status -sb
如果旧工作树里还有想要的代码,直接在那个目录里新建临时分支提交,或导出补丁留底:
bash
git -C "/path/to/old-worktree" diff > ~/rescue-codex.patch
2. 规范删除目录并修剪孤儿元数据
确认里面的改动都已经安全迁移或不再需要后,使用官方命令解绑并删除:
bash
# 1. 正常移除已存在的废弃 worktree(若含未跟踪临时文件可加 --force)
git worktree remove "/path/to/old-worktree"
# 2. 清理目录已被手工删除但 .git/worktrees 里还留着锁的孤儿记录
git worktree prune -v
# 3. 顺手删掉已合并或废弃的临时分支
git branch -d codex/temp-branch-name
执行完后再跑一次 git worktree list,确认只剩下主仓库与当前活跃工作树即可。想了解更多桌面端与 CLI 多窗口接力技巧,可延伸阅读 /guides/codex-app-cli-handoff-multi-project-window-guide。
三、提前防错:给 Codex 加上分支护栏(本站建议)
事后抢救不如事前拦住。建议在仓库的 AGENTS.md 顶部写入一条明确约定(加载机制详见 /guides/codex-agents-md-how-it-reads):「开始修改任何文件前,先检查 git branch --show-current;如果当前位于 main 或 master,先提示用户或自动新建 feat/ / fix/ 分支后再改动,禁止直接向主分支提交」。若你在新建临时目录跑 Codex 时遇到目录信任校验提示,可参考 /guides/codex-not-inside-trusted-directory-skip-git-repo-check。
常见问题
问:如果我已经不小心把错分支上的提交 git push 到了远端,还能用 git reset --hard 强推吗?
答:如果是团队共享的 main 或受保护分支,切勿随意强推覆盖历史。正确做法是先新建功能分支保住提交,再在共享分支上用 git revert <commit-hash> 生成一条安全的反向回滚提交并推送;仅在个人私有功能分支确认无人协作时,才考虑使用更安全的 git push --force-with-lease。
问:为什么我手动把 .codex/worktrees 下的文件夹删干净了,切换分支还是提示被占用?
答:因为主仓库的 .git/worktrees/<name> 里还留着指向已删除路径的登记元数据。直接运行 git worktree prune -v 即可自动清空失效锁记录。更多高频环境异常可统一查阅 /guides/codex-common-errors-summary。
问:国内没有外币信用卡,或者多分支并行开发额度不够想升级 ChatGPT Pro / 团队版怎么办理?
答:可前往本站 AI 会员充值总览 按需选购 ChatGPT Plus 充值(含 Plus iOS 可覆盖版)或高配额 ChatGPT Pro 20x 档位,多人团队亦可选择企业定制方案。支持支付宝、微信支付与 AlipayHK,提供自助卡密兑换与增值税发票服务,具体以商品页实时展示为准;售后遵循掉订阅按剩余天数折退、封号不在质保范围内的规则。
相关教程
- Codex 改坏代码怎么安全撤回、回滚与核对 Git Diff
- Codex 桌面端与 CLI 多项目窗口接力指南
- Codex 如何读取与合并 AGENTS.md 指令文件
- Codex 提示不在受信任目录或跳过 Git 仓库检查怎么处理
- Codex 常见报错总表
参考资料
- Git 官方文档:git-worktree — https://git-scm.com/docs/git-worktree
- Git 官方文档:git-stash — https://git-scm.com/docs/git-stash
- OpenAI Codex 官方开发者文档 — https://developers.openai.com/codex
- OpenAI Codex 官方 GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~