概覽
「程式碼審查」將 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 審查本機變更。如要了解本機審查選項,請參閱程式碼審查指南。
這次更新會將我現有的雲端審查移至新的雲端環境嗎?
不會。這次更新不會將現有的雲端程式碼審查遷移至新的雲端環境。
