結論先說
- 先用
git diff -w做秒級甄別。如果git diff滿屏飄紅,但git diff --ignore-cr-at-eol或git diff -w裏只有你真正改的那幾行,就說明 100% 是換行符(CRLF 與 LF)打架,千萬不要把這種整頁假 Diff 直接提交進業務 PR。 - 最根本的解法是在倉庫放
.gitattributes,而不是折騰每個人的全局 Git 配置。在根目錄顯式寫明* text=auto eol=lf,並為 Windows 專用腳本(.bat/.cmd)單獨留例外,就能把換行規則鎖死在倉庫層面。 - 警惕 Windows PowerShell 的隱形編碼重寫(本站建議)。如果 Codex 在工具調用裏用舊版 PowerShell 5.1 的
Set-Content或Out-File寫文件,極易把原本無 BOM 的 UTF-8 LF 文件覆寫成帶 BOM 的 CRLF 甚至本地代碼頁 GBK。 - 把換行與編碼硬規矩寫進
AGENTS.md。明確告知 Codex 修改文件時必須沿用原文件 LF 換行與無 BOM UTF-8 編碼,優先用原生補丁工具而非 Shell 重定向覆寫整文件。 - 跨平台工程高頻重構和審查很吃上下文額度。在 Windows 上長期用 Codex 跑全棧開發的團隊和個人,可在本站按需開通 ChatGPT Plus 或高額度 ChatGPT Pro,團隊多人採購可查看 ChatGPT Business 團隊定製。

圖:本站根據 Git 官方 gitattributes 文檔 與 Windows 排障經驗整理的示意圖
本文根據 Git 官方gitattributes文檔、OpenAI Codex Windows 文檔及跨平台工程排障實踐整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 在 Windows 上用 Codex CLI 或桌面端修改完三行代碼,運行
git diff卻發現整個文件 400 行全部被標記為刪除再新增的開發者; - 團隊同時有 Windows、macOS、Linux 成員或 Docker 容器,經常因 Codex 改完
.sh、Dockerfile 或配置文件後冒出^M報錯、CI 校驗不通過的人; - 在 PowerShell 環境下遇到中文註釋亂碼、UTF-8 BOM 頭污染或權限位莫名變更的開發者。
一、為什麼 Windows 上用 Codex 特別容易爆出整頁假 Diff
很多人以為是模型把整個文件重新生成了一遍,其實背後通常是三種環境疊壓:
- 本地
core.autocrlf與倉庫實際格式錯位:Git for Windows 安裝嚮導預設勾選core.autocrlf = true(檢出轉 CRLF、提交轉 LF)。當倉庫裏混存着歷史 CRLF 文件,或者 Codex 內置補丁工具按 LF 寫回磁盤時,Git 就會把每一行末尾從\r\n變成\n全部標紅。 - Shell 輔助腳本帶入 BOM 或換行切換:如果任務裏讓 Codex 執行了一段 PowerShell 一行命令去批量替換文本,Windows PowerShell 5.1 預設寫入 CRLF 且可能附帶 UTF-8 BOM(
EF BB BF),不僅在 PR 審查介面炸出整頁變更,還會讓 JSON、TOML 或容器內的.sh腳本直接報錯。關於 PowerShell 中文亂碼與反斜槓轉義問題,可一併對照 /guides/codex-cli-windows-powershell-utf8-garbled-backslash-fix。 - WSL 與 NTFS 跨文件系統權限位漂移:在 Windows 與 WSL2 混用同一個倉庫目錄時,除了換行符外,還常出現文件無內容變動卻報
old mode 100644 -> new mode 100755的假 Diff。
先用下面兩條命令摸清現狀:
powershell
# 1. 查看指定文件在 Git 索引(i/)與工作區(w/)的實際換行符
git ls-files --eol src/app.ts
# 2. 忽略回車差異,只看真正改動的邏輯行
git diff --ignore-cr-at-eol src/app.ts
二、4 步根治換行符假 Diff 與編碼污染
以下為本站建議的標準化治理順序,個人倉庫與多人團隊都可直接套用:

圖:本站根據 Git 官方規範與跨平台團隊實踐整理的示意圖
第 1 步:在倉庫根目錄落地 .gitattributes
在項目根目錄創建或更新 .gitattributes,把跨平台文本、Shell 腳本和二進制文件一次性劃分清楚:
gitattributes
# 預設所有文本文件自動識別並統一以 LF 存儲和檢出
* text=auto eol=lf
# 關鍵源碼與腳本強制 LF,防止容器與 CI 報 ^M 錯誤
*.sh text eol=lf
*.py text eol=lf
*.ts text eol=lf
*.tsx text eol=lf
*.js text eol=lf
*.json text eol=lf
*.yml text eol=lf
*.yaml text eol=lf
*.md text eol=lf
Dockerfile text eol=lf
# Windows 專用批處理按需保留 CRLF
*.bat text eol=crlf
*.cmd text eol=crlf
# 二進制資源嚴禁 Git 動換行符
*.png binary
*.jpg binary
*.pdf binary
*.zip binary
第 2 步:對齊本機 Git 配置與 .editorconfig
有了 .gitattributes 兜底後,建議在 Windows 開發機上把當前倉庫或全局 Git 設定調整為不隨意自動改寫換行符,同時關閉 NTFS 權限位誤報:
powershell
git config --global core.autocrlf input
git config --global core.safecrlf warn
git config core.filemode false
同時在根目錄補充一份極簡 .editorconfig(設定 charset = utf-8 與 end_of_line = lf),讓 VS Code、JetBrains 以及格式化工具與 Git 保持完全一致。
排障與訂閱提示:在 Windows 上既要調沙箱環境又要維護跨平台構建腳本,如果連續排查導致 Plus 短週期配額緊張,可在本站升級 ChatGPT Pro 充值 或選擇 ChatGPT Pro 5x iOS 可覆蓋檔;若新註冊帳號遇到手機校驗攔路,也可查看 Codex 註冊手機驗證服務。
第 3 步:把編碼與換行規矩寫進 AGENTS.md(本站建議)
在項目根目錄的 AGENTS.md 加上簡明約定,讓 Codex 每次動代碼前先看規矩(關於加載機制可看 /guides/codex-agents-md-how-it-reads):
markdown
## 文件編碼與換行約定
- 所有源碼、配置文件與 Shell 腳本必須使用無 BOM 的 UTF-8 編碼與 LF 換行符。
- 在 Windows 環境修改文件時,避免使用會預設寫入 CRLF/BOM 的 PowerShell 重定向覆寫整個文件。
- 提交前檢查 `git diff --check` 與 `git ls-files --eol`,禁止把整頁換行符變動混入功能改動。
第 4 步:無損清理當前假 Diff,並隔離歷史歸一化
如果眼前已經出現了整頁假 Diff,先不要直接 git commit:
- 只救眼前這一個業務分支:先確認邏輯改動無誤後,用一行 Python 僅把誤轉 CRLF 且未帶 BOM 的目標文件轉回 LF(避免動到真正的新代碼):
powershell
python -c "import pathlib; p=pathlib.Path('src/app.ts'); p.write_bytes(p.read_bytes().replace(b'\r\n', b'\n'))"
如果改動太亂想回退重來,可參考 /guides/codex-undo-bad-changes-rewind-git-diff-rollback-guide 安全回滾。
- 全倉歷史統一歸一化單獨提一個 PR:當工作區完全乾淨時,新增
.gitattributes後執行git add --renormalize .,將其作為獨立一次提交chore: normalize line endings to LF,千萬不要夾帶在功能開發提交裏,否則審閱者根本沒法看git blame與代碼 Diff。
常見問題
問:加上 .gitattributes 後,為什麼舊文件在本地還是 CRLF?
答:.gitattributes 不會自動改寫你工作區裏已經檢出好的舊文件。需要先確保沒有未儲存的業務修改,再運行 git add --renormalize . 並提交一次純歸一化變更,或者重新刷新工作區檢出,規則才會對存量文件生效。
問:除了假 Diff,我在 Windows 上跑 Codex 還遇到文件被佔用(os error 32)怎麼辦?
答:那屬於 Windows 沙箱刷新時的文件句柄佔用衝突,與 Git 換行符不是一類問題,請直接對照 /guides/codex-windows-helper-unknown-error-os-error-32-fix 清理殘留進程並更新客戶端;其他高頻報錯可統一查 /guides/codex-common-errors-summary。
問:國內沒有外幣信用卡,或者日常重度開發想升級 ChatGPT Pro / 團隊版怎麼辦理?
答:可前往本站 AI 會員充值總覽 按需選購 ChatGPT Plus 充值(含 Plus iOS 可覆蓋版)或高配額 ChatGPT Pro 20x 檔位,多人團隊亦可選擇企業定製方案。支持支付寶、微信支付與 AlipayHK,提供自助卡密兌換與增值稅發票服務,具體以商品頁實時展示為準;售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍內的規則。
相關教學
- Codex CLI 在 Windows PowerShell 下 UTF-8 亂碼與反斜槓修復
- Codex 改壞代碼怎麼安全撤回、回滾與核對 Git Diff
- Codex Windows 報 helper_unknown_error 或 os error 32 修復
- Codex 如何讀取與合併 AGENTS.md 指令文件
- Codex 常見報錯總表
參考資料
- Git 官方文檔:gitattributes — https://git-scm.com/docs/gitattributes
- OpenAI Codex 官方開發者文檔 — https://developers.openai.com/codex
- OpenAI Codex 官方文檔:Windows sandbox — https://learn.chatgpt.com/docs/windows/windows-sandbox
- OpenAI Codex 官方 GitHub 倉庫 — https://github.com/openai/codex
0 條評論
還沒有評論,來搶沙發~