結論先說
- 發現改錯分支時,第一條鐵律是停手別敲
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 條評論
還沒有評論,來搶沙發~