Codex 在 Windows 上改代碼把換行符全變成 CRLF 或產生整頁假 Diff 怎麼辦:.gitattributes 與編碼防坑

在 Windows 上讓 Codex 改兩行代碼,git diff 卻冒出整頁幾百行紅綠改動,甚至把 .sh 腳本改成 CRLF 跑不起來?本文教你用 .gitattributes 與編碼規範一次根治。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

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

Windows 整頁假 Diff 分流排查

圖:本站根據 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 與編碼污染

以下為本站建議的標準化治理順序,個人倉庫與多人團隊都可直接套用:

根治 CRLF 假 Diff 與編碼 4 步

圖:本站根據 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:

  1. 只救眼前這一個業務分支:先確認邏輯改動無誤後,用一行 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 安全回滾。

  1. 全倉歷史統一歸一化單獨提一個 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,提供自助卡密兌換與增值稅發票服務,具體以商品頁實時展示為準;售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍內的規則。

相關教學

參考資料

  • 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 整理家庭裝修預算明細、隱蔽工程驗收清單與主材優缺點對比表實戰

    第一次裝修面對幾十頁施工報價單、密密麻麻的水電防水隱蔽項目與五花八門的主材參數,極易踩坑增項。本文梳理用 ChatGPT 審查裝修報價漏項、生成帶公式的預算明細表、定製工地隱蔽工程驗收單與主材對比表的實戰提示詞。

    ChatGPT0
  2. 02

    用 ChatGPT 做費曼學習法讀書共讀:反向追問檢驗自己是否真讀懂專業書籍與整理書單筆記

    讀完一本專業硬書常感覺「合上書就忘」,直接讓 AI 概括全書又容易產生懂了的錯覺。本文介紹用 ChatGPT 結合 Study Mode 與費曼學習法做反向追問共讀,通過通俗複述、挑刺盲區到沉澱書單卡片的完整流程與提示詞。

    ChatGPT0
  3. 03

    用 ChatGPT 做外貿產品多語種目錄、展會邀約與客戶跟進節奏表(附脫敏與本地化提示詞)

    做外貿展會與海外推廣時,手工翻譯十幾款產品目錄費時且容易留下一堆中式英文,展後客戶跟進也常缺節奏。本文梳理用 ChatGPT 先脫敏建術語庫、再批量產出多語種目錄、展前邀約函與展後 21 天跟進節奏表的實戰流程與提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫高質素技術專欄文章、開源項目 Release Notes 與版本更新日誌實戰

    讓 AI 直接憑空寫技術文章容易滿篇空洞套話,直接甩 Git 記錄寫更新日誌又常常漏掉破壞性變更。本文整理用 ChatGPT 結合真實代碼片段、壓測數據與 PR 摘要,高效產出深度技術專欄、GitHub Release Notes 與 CHANGELOG 的實戰工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做產品用戶訪談紀要編碼、提煉高頻痛點需求池與 RICE 優先級打分實戰

    手頭攢了十幾份用戶訪談逐字稿,手工貼便利貼歸納痛點耗時又容易帶入主觀偏見。本文分享用 ChatGPT 完成脫敏檢查、逐份開放式編碼、跨樣本聚類高頻痛點並搭建 RICE 優先級打分表的 5 步實戰流,附可直接複製的三段核心提示詞。

    ChatGPT0
  6. 06

    ChatGPT 網頁版上載超過 10 個文件或回形針附件按鈕變灰怎麼辦:打包合併與配額限制排查

    在 ChatGPT 網頁版批量分析文檔時,常遇到一次選超 10 個文件被攔截或輸入框回形針按鈕變灰。本文依據 OpenAI 文件上載與存儲說明,梳理 6 類常見報錯的分流排查法,提供 ZIP 打包、本地合併與 Projects 複用方案及可直接複製的解包提示詞。

    ChatGPT0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~