3-7 透過 Cursor 協助 Code Review

2025年4月19日

持續學習最新的 AI 應用
更多深入的 AI 內容,都在 E+ 成長計畫 👉前往了解

在前面的單元中,我們分別探討了如何使用 Cursor 撰寫生成 commit 訊息以及編寫 PR 的描述。在這個單元,我們將進一步介紹如何在團隊中協助進行 code review ,並利用 Cursor 來提升效率。

假設你是新加入團隊的人,對團隊的程式碼庫還不熟悉;或者你是一個剛畢業的新人,對如何進行 code review 缺乏經驗;又或者你是資深工程師,在完成自己的 code review 後想確保評審足夠全面。在這些情況下,Cursor 都能派上用場。接下來,我們透過實際展示來說明如何利用 Cursor 進行 code review 。

操作步驟

要使用 Cursor 進行 code review ,首先建議將團隊其他成員提交的 PR 拉到自己的本地端,然後切換到該 PR 使用的分支。接著,可以利用前面提到過的 @git 指令,調出該分支相關的 Git 歷史紀錄。這樣就能針對某個 commit 或該分支與主分支之間的差異進行審查。

這邊推薦一個重要的前提,是團隊要有一份風格指南 (Style Guide)。風格指南能確保程式碼的一致性,舉例來說,Airbnb 提供的開源 JavaScript 風格指南,在 GitHub 上獲得超過 10 萬顆星,明確規範了撰寫 JavaScript 的風格。Google 也公開了多種程式語言 (如 C++、Go、JavaScript、Java 等) 的風格指南,供開發者參考。

將風格指南融入 Cursor

有了風格指南後,可以將其加入 Cursor 的文件中。具體做法是:

  • 在 Cursor 的 Features 中找到「Docs」功能
  • 將風格指南文件加入
  • 在審查時,直接引用這些指南,例如輸入「用 JavaScript Style Guide 來 Review 某個 PR」
在 Cursor 中新增風格指南
在 Cursor 中新增風格指南

提交後,Cursor 會根據風格指南分析程式碼,並提出建議,確保 PR 中的程式碼與整體程式碼庫的風格一致。

請 Cursor 根據 JavaScript 風格指南 code review
請 Cursor 根據 JavaScript 風格指南 code review

利用決策脈絡進行審查

除了風格指南,我們之前提到的決策脈絡紀錄,也能用於 code review。除了用 @Git ,在用 Cursor 看程式碼時,不一定只能針對整個 PR。也可以鎖定單一檔案或程式碼片段進行審查。例如,將某個 React 元件檔案引用進來,讓 Cursor 根據 React 的原則提出改進建議。

提升 Code Review 的友善性與建設性

在進行 code review 時,有一個非常值得注意的重點:用詞需謹慎,避免情緒化或衝動的表達。特別是當團隊成員犯了不該犯的錯誤,或重複出現你之前已指出的問題時,有些人可能會感到不耐煩,導致評語語氣變差。然而,若想打造正向且持續成長的團隊文化,應避免使用帶有情緒的字眼。

具體做法是,在 Cursor 中新增提示詞,例如「請幫我將 code review 文字改得更友善、有建設性且專業」。將帶有情緒的評語貼進去,例如:「這邊寫法很糟糕,可讀性超差,特定 magic number 應該抽出來,之前不是說過不要這樣寫嗎?怎麼講不聽?!!!」

提交後,Cursor 會將這段文字改進為更專業且友善的版本。這樣的調整能確保 code review 聚焦於程式碼而非個人,並以理性、有建設性的方式進行,從而提升團隊文化。

Cursor 協助把情緒化的評語改為理性且友善的版本
Cursor 協助把情緒化的評語改為理性且友善的版本

此系列文章為 《給工程師的 Cursor 工作流 — 透過 AI 代理全方位提升開發生產力》 搭配的教材。希望透過這系列文章,將過去協助導入 AI 工具及使用 Cursor 的經驗擴展並分享給想提升生產力的讀者。如果對課程感興趣的讀者,可以加入 E+ 成長計畫,觀看影片學習。

🧵 如果你想收到最即時的內容更新,可以在 FacebookInstagram 上追蹤我們