Codex 本地 codex review 進階用法:按 --base 分支對比、--uncommitted 查未提交改動與自定審查重點

提交前想用本地 codex review 查漏補缺,卻遇到 --base 和自定義提示詞混用報錯?本文講清 --uncommitted、--base、--commit 三種原生範圍用法,以及用 AGENTS.md、獨立提示詞和管道組合自定義審查重點的正確姿勢。

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

結論先說

  1. codex review 提供三種標準只讀範圍參數:--uncommitted、--base <分支> 與 --commit <SHA>。它們只審代碼不改源碼,分別對應「提交前自檢」「提 PR 前整分支對比」「單次提交審計」三個高頻節點。
  2. 注意最容易踩的參數互斥坑:--base 等範圍參數不能直接和命令行 [PROMPT] 同時傳。在較新版 CLI 中混用會直接報 cannot be used with '[PROMPT]',不要把兩者硬拼在同一條命令裏。
  3. 自定義審查重點有三條正確路徑,按複用頻率選一條即可。團隊長期規範寫進 AGENTS.md(配合 --base / --uncommitted 自動生效);單次專項檢查直接用 codex review "在提示詞內寫明對比分支與重點";複雜管道過濾則交給 git diff | codex exec --sandbox read-only。
  4. 先跑本地預審再提 PR,能大幅減少人工 Review 裏的低級返工。把空指針、邊界條件、SQL 拼接和漏清理的資源在本地消掉,讓團隊評審精力聚焦在架構設計與業務語義上。
  5. 每次提交與發版前高頻跑本地大分支代碼審查會消耗較多上下文額度。國內沒有外幣卡的用戶可在本站自助開通 ChatGPT Plus 或高配額的 ChatGPT Pro,團隊多人研發可了解 ChatGPT Business 團隊定製。

codex review 四種本地審查入口對比

圖:本站根據 OpenAI Codex 官方文檔:Code review 整理的示意圖

本文根據 OpenAI Codex 官方文檔《Code review》《Command line options》《AGENTS.md》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。

適用於誰

  • 希望在 git commit 或提交 Pull Request 前,用一行本地命令先讓 Codex 替自己把高危缺陷攔下來的開發者;
  • 運行 codex review --base main "重點查並發問題" 時遇到參數衝突報錯,不知道怎麼把範圍參數與自定審查重點結合起來的人;
  • 想把團隊統一的安全基線、接口兼容紅線沉澱成自動化預審流程的研發負責人。

一、--uncommitted、--base 與 --commit 三種原生範圍用法

相比自己手工拼複雜的 git diff 腳本,codex review 內置了面向代碼缺陷識別的專用評審流程(基礎入門介紹見 /guides/codex-code-review)。按開發階段選對參數即可一行開審:

命令寫法審查覆蓋範圍最佳觸發時機
codex review --uncommitted暫存區、未暫存改動與新增未追蹤文件執行 git commit 前快速自查
codex review --base main當前特性分支相對目標主幹分支的完整差異準備提 PR / MR 前做整分支體檢
codex review --commit <SHA>某一個指定歷史提交引入的改動覆核線上緊急熱修或 Cherry-pick 提交
codex review "<審查指令>"按自定義提示詞中指定的目標與側重點審查臨時專項排查(安全、性能或契約核對)

日常高頻命令示範

bash
# 1. 提交前檢查本機所有未提交改動(含暫存、未暫存與新文件)
codex review --uncommitted

# 2. 提 PR 前對比當前分支相對 origin/main 或 main 的全部改動
codex review --base main

# 3. 單獨審查某一次線上熱修提交
codex review --commit a1b2c3d

二、繞開參數衝突:自定義審查重點的三種正確姿勢

自定審查重點怎麼選:三種正確方案分診

圖:本站根據 OpenAI Codex 官方文檔:Command line options 整理的示意圖

不少教學會寫出 codex review --base main "重點查 SQL 注入",但在實際 CLI 參數解析裏,原生範圍開關(--base、--uncommitted、--commit)與位置提示詞 [PROMPT](含標準輸入 -)是互斥路徑,直接混傳會報參數衝突錯誤。想既控制範圍又定製關注點,按場景選下面三種標準做法即可:

方案 A:把團隊固定評審標準寫進 AGENTS.md(長期最省心)

codex review 在運行 --base、--uncommitted 或 --commit 時,會自動讀取倉庫中的 AGENTS.md(層級規則見 /guides/codex-agents-md-how-it-reads)。只要在倉庫根目錄的 AGENTS.md 裏新增一段審查細則,團隊成員每次只需敲極簡命令就能自動按統一口徑檢查:

markdown
## Code Review 重點規則
- 優先報告可能導致越權訪問、SQL 注入、資金重複扣減或並發競態的高危問題;
- 凡修改對外 HTTP 接口請求或響應字段,必須核查是否破壞舊版客戶端向後兼容;
- 忽略純代碼格式與個人命名偏好,每條結論必須給出精確文件路徑與復現條件。

儲存後直接運行 codex review --base main,模型便會嚴格套用這些紅線進行整分支預審。

方案 B:單次專項排查直接用獨立 [PROMPT] 或標準輸入

如果你不想改動倉庫的 AGENTS.md,只想臨時查一次特定風險,直接去掉 --base 等互斥開關,把對比範圍和審查重點一起寫進提示詞裏:

bash
# 直接通過獨立提示詞說明範圍與重點
codex review "請對比當前分支相對 main 分支的所有改動,僅聚焦檢查數據庫事務邊界、未捕獲異步異常與接口向後兼容性。"

# 或把本地專項核對清單文件通過標準輸入餵給 codex review
cat .github/security-review-checklist.md | codex review -

方案 C:需要高度定製輸出格式或過濾文件時改用管道 + codex exec

如果你只想審 src/payments/ 子目錄相對 main 的差異,或者希望把審查意見直接重定向儲存成 Markdown 報告文件,用 git diff 管道配 codex exec --sandbox read-only 最靈活(更多管道配方見 /guides/codex-cli-pipe-stdin-exec-recipes):

bash
git diff main...HEAD -- src/payments/ | codex exec --sandbox read-only \
  "請僅從冪等性、並發鎖與錯誤重試三個維度審查以下支付模組改動,按高/中/低風險分級輸出。" > pay-review.md
訂閱與帳號準備提示:對包含數十個文件的大特性分支反覆執行 --base 整分支預審,加上修復後再二次複審,會顯著提升上下文配額消耗。若 Plus 檔在迭代發版周容易觸頂,可在本站升級 ChatGPT Pro 充值 或選用 ChatGPT Pro 5x iOS 可覆蓋檔;新註冊 OpenAI 帳號若卡在短訊驗證環節,可先查看 Codex 註冊手機驗證服務。

三、本站建議:提升本地預審信噪比的三個實操習慣

AI 審查最怕吐出一堆無關痛癢的風格建議,淹沒真正致命的邏輯缺陷。本站建議養成下面三個習慣(常用命令行搭配見 /guides/codex-cli-commands-cheatsheet):

  1. 大分支拆成「未提交小步審 + 合併前整分支審」兩段:每次寫完一個清晰子功能先跑一次 codex review --uncommitted 及時清隱患,等全部提交整理完畢臨提 PR 前再跑一次 codex review --base main 查跨提交整體一致性。
  2. 明確排除噪音項:在 AGENTS.md 或專項提示詞裏顯式寫明「跳過鎖文件、自動生成代碼與純格式調整,僅報告有明確觸發條件的缺陷」,能明顯降低誤報。
  3. 堅持人工核驗業務意圖:本地 codex review 擅長捕捉漏判空值、越界、資源泄漏和常見安全漏洞,但無法替代你判斷需求本身是否合理;修完每條高風險意見後記得重跑對應單測再推送代碼。

常見問題

問:運行 codex review --base main 時提示找不到目標分支或差異不準怎麼辦?

答:先在本地執行 git fetch origin 同步遠端最新主幹,再改用 codex review --base origin/main 對比最新的遠端主幹提交,避免拿本地落後很久的舊 main 分支做參照。

問:運行 codex review 會不會趁機直接幫我修改本地源碼文件?

答:不會。codex review 是隻讀性質的審查子命令,只負責讀取倉庫與差異並輸出問題清單和修復建議,不會擅自改寫你的工作區源碼;確認某條建議合理後,再由你手工修改或開常規會話落盤修復。

問:國內沒有外幣信用卡,或者研發團隊需要開增值稅發票報銷,怎麼開通適合高頻跑本地代碼審查的 Codex 訂閱?

答:可通過本站 AI 會員充值總覽 辦理 ChatGPT Plus 卡密自助兌換 或高配額 ChatGPT Pro,多人研發團隊可直接選擇 ChatGPT Business 團隊定製。支持支付寶、微信支付及 AlipayHK 付款,無需提供帳號密碼,可開具增值稅發票;實時價格以商品頁為準,售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的規則。

相關教學

參考資料

  • OpenAI Codex 官方文檔:Code review — https://learn.chatgpt.com/docs/code-review
  • OpenAI Codex 官方文檔:Command line options — https://learn.chatgpt.com/docs/developer-commands
  • OpenAI Codex 官方文檔:AGENTS.md — https://learn.chatgpt.com/docs/agent-configuration/agents-md

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 條評論

登入 後參與評論

還沒有評論,來搶沙發~