概覽
「程式碼審查」將 pull request、程式碼變更、審查發現、留言和檢查結果集中在同一處。你可以審查他人的變更、追蹤自己 pull request 的意見回饋,或在回覆前請 Codex 說明某項變更。
「程式碼審查」外掛程式支援在桌面版和網頁版進行審查。GitLab 合併請求審查已推出預覽版。目前不支援 GitLab 雲端程式碼審查。
開始之前
請使用有權存取待審查 pull request 的程式碼庫帳戶。你的程式碼庫權限決定了你可以讀取或變更哪些內容。
在受管理的工作區中,你必須能使用「程式碼審查」外掛程式及所有必要的應用程式連線。安裝外掛程式不會授予程式碼庫的存取權。
如需瞭解外掛程式設定和工作區控管,請參閱ChatGPT 和 Codex 中的外掛程式。
尋找 pull request
開啟「程式碼審查」,尋找你建立或受邀審查的 pull request。使用搜尋和篩選縮小清單範圍,再選取一個 pull request。
確認程式碼庫、標題、作者和分支,確保你正在審查的就是目標變更。描述會說明作者的目標;差異比較則顯示哪些程式碼有變更。
審查變更
閱讀 pull request 的描述和摘要。
在差異比較中檢視已變更的檔案及相關程式碼行。
檢視審查發現和現有留言。
查看測試結果、檢查項目,以及任何尚未解決的合併衝突。
針對需要進一步探究的問題詢問 Codex。
在採信產生的審查發現之前,請先對照相關程式碼確認。
向 Codex 詢問 pull request 的相關問題
在 pull request 的對話中,針對變更提出問題,或深入探討某項審查發現。請說明你關注的程式行為或審查標準。例如:
「說明這項變更如何影響登入。」
「檢查新增的錯誤處理路徑是否會釋放資料庫連線。」
「顯示作為這項審查發現依據的程式碼。」
「將這次修訂與審查意見進行比對,找出尚未解決的問題。」
你也可以請 Codex 準備修正。描述你想要的變更及其範圍限制,然後檢查產生的差異比較和測試結果。
例如:「修正審查中發現的錯誤處理問題。將變更限制在這個函式內,並針對失敗案例新增測試。」
在送出留言、提交變更或合併之前,請先審查結果。
審查 GitLab 合併請求
GitLab 預覽版將合併請求整合至「程式碼審查」。你可以檢查變更,並使用 Codex 協助理解及處理審查意見。
請使用與你要審查的帳戶和專案相對應的 GitLab 連線。如需瞭解連線選項和程式碼庫權限,請參閱將 GitLab 連接至 ChatGPT 和 Codex。
應用程式內的預覽版不包含 GitLab 雲端程式碼審查。連接 GitLab 或在「程式碼審查」中看到合併請求,並不會啟用該程式碼庫的自動雲端審查。
常見問題
可以在建立 pull request 前審查本機變更嗎?
可以。你可以請 Codex 審查本機變更。如需瞭解本機審查選項,請參閱程式碼審查指南。
這會將我現有的雲端審查移至新的雲端環境嗎?
不會。這次更新不會將現有的雲端程式碼審查移轉至新的雲端環境。
