調教你的 AI 副手
想像你的 AI 助理像個新手實習生，什麼都懂一點，但總是寫出不符專案風格的程式碼？現在，我們來升級它！透過 .cursorrules，你可以「調教」AI，讓它從泛泛的幫手變成超懂你專案的資深夥伴。
這篇教學延續上篇「結界術」，更進階，專注於提升程式碼品質，讓 AI 產出的代碼更一致、更專業！
為什麼需要 .cursorrules？
.cursorrules 就像給 AI 一本「專案手冊」，提供持久的上下文，讓 AI 在生成程式碼時遵循你的規則。它能：
- 提升程式碼品質：強制 AI 遵守命名慣例、風格指南（如 Airbnb 風格）。
- 符合專案風格：讓 AI 知道你的架構偏好（如使用 TypeScript、特定框架）。
- 減少修正時間：AI 不再亂寫，從源頭確保代碼乾淨、一致。
這與 .cursorignore 或 .cursorindexingignore 不同，前者是「防禦」，這是「進攻」——引導 AI 產生更好輸出。
步驟 1：建立 .cursorrules 檔案
- 在專案根目錄下，建立一個名為 .cursorrules 的檔案。
- 用文字編輯器（例如 VS Code）打開它。
- 開始寫入規則，每條規則簡短明確，AI 會在生成程式碼時參考這些。
步驟 2：寫入調教規則
.cursorrules 的語法超簡單：每行一條規則，用自然語言描述就好。AI 會將這些規則整合進提示中。以下是常見範例，涵蓋風格、語言和架構：
# 程式碼風格規則：確保一致性
一律使用 Airbnb JavaScript 風格指南進行程式碼格式化。
優先使用 const 宣告變數，需要重新賦值時使用 let，絕對避免使用 var。
# 語言與框架偏好：讓 AI 懂你的專案
所有新的 JavaScript 檔案使用 TypeScript 撰寫。
React 組件盡可能使用 Hooks。
後端路由遵循 MVC 架構。
# 避免常見錯誤：防患未然
不要使用 console.log 進行除錯，改用日誌模組（如 winston）。
所有函數必須包含 JSDoc 註解進行文件化。
避免使用全域變數，將狀態封裝在模組中
規則說明：
- 每條規則用英文寫，AI 理解更準，但我個人其實僅使用中文。
- 如果 AI 對中文規則理解不佳，可將關鍵規則保留英文。
- 保持簡短：每條規則 1-2 句，避免過長導致 AI 忽略。
- 分類組織：用 # 註解分組，讓檔案易讀。
常見問題與解法
- 問題：AI 忽略了我的規則！
解法：確認 .cursorrules 在專案根目錄，檢查是否與全域規則（Cursor 設定中的 Rules for AI）衝突。 - 問題：規則太多，AI 處理不過來怎麼辦？
解法：保持 10-20 條規則，分成多個檔案（例如 .cursorrules-frontend、.cursorrules-backend），或用優先順序排序。 - 問題：我想讓規則適用於特定資料夾？
解法：目前 .cursorrules 是專案級別，但你可以指定路徑規則，如 "For files in src/components, use functional components only."。
你的 AI 副手已上線！
透過 .cursorrules，你成功調教 AI，讓它從實習生變成最勤快的小助理，產出的程式碼更專業、更貼合專案！
快速回顧：
- 建立檔案：在專案根目錄新增 .cursorrules。
- 寫入規則：用簡單描述指定風格、語言和架構。
- 測試效果：確保 AI 生成的程式碼品質提升。
現在，試著在你的專案中應用吧！結合上篇的「結界術」，你的 Cursor 將變得無敵強大！
分享你的 .cursorrules 規則在留言區，讓大家一起交流調教心得！
