第 1 張|Cursor AI 簡介
什麼是 Cursor?
- 以 VS Code 為基礎打造的 AI 原生程式碼編輯器
- 由 Anysphere 公司開發,2023 年正式推出
- 深度整合 LLM(Claude、GPT-4o 等),理解整個程式碼庫
核心理念
AI 應該完全了解你的程式碼庫,而非只看幾行程式碼。透過 Embeddings 技術,跨越整個專案理解架構與依賴。
為什麼值得使用?
- ✓ 遠超傳統補全工具的智慧程度
- ✓ Agent 模式可自動完成複雜開發任務
- ✓ 相容幾乎所有 VS Code 擴充套件
- ✓ 免費方案即可體驗核心功能
第 2 張|Chat 功能
開啟方式
Ctrl+L(Windows/Linux)或 Cmd+L(Mac)
Chat 能做什麼?
- 詢問程式碼邏輯與設計意圖
- 解釋複雜演算法或架構
- 生成測試、文件、README
- 提供除錯建議與最佳化方向
強大的 @ 引用語法
@src/utils/helper.ts # 引用特定檔案
@src/components/ # 引用整個資料夾
@codebase # 搜尋全部程式碼庫
@errors # 引用最近的錯誤訊息
@https://docs.react.dev # 引用網路文件
越精確的引用 = 越精準的 AI 回覆
第 3 張|Agent 模式
開啟方式
Ctrl+I(Windows/Linux)或 Cmd+I(Mac)
Agent 的超能力
- ✓ 讀取並修改多個檔案
- ✓ 執行終端指令(安裝套件、跑測試)
- ✓ 建立新檔案與資料夾
- ✓ 根據錯誤自動修正並重試
使用原則
把大任務拆成小步驟。每完成一步,確認後再繼續。永遠審查 Agent 生成的程式碼差異(diff)。
典型任務範例
"重構 UserProfile 元件,拆分為 3 個子元件,
保持現有功能,更新所有相關引用"
第 4 張|Tab 補全與 Cmd+K
Tab 智慧補全
- 基於整個程式碼庫的上下文預測
- 能預測整個程式碼區塊,不只是一行
- Tab 接受建議 | Esc 拒絕
- → 逐字接受建議
Cmd+K 行內編輯
選取程式碼 → 按 Ctrl+K 或 Cmd+K → 輸入修改需求
// 常用 Cmd+K 指令
"加入 TypeScript 型別定義"
"重構為 async/await 風格"
"加入完整的錯誤處理"
"加入 JSDoc 說明文件"
"改為 early return 模式"
接受 / 拒絕變更
第 5 張|Rules for AI 設定
什麼是 .cursorrules?
放在專案根目錄的設定檔,告訴 AI 每次回覆時應該遵守什麼規範。
.cursorrules 應該包含什麼?
- ✓ 角色定義(你是誰、用什麼技術棧)
- ✓ 程式碼風格規範(縮排、命名、格式)
- ✓ 架構原則(目錄結構、設計模式)
- ✓ 禁止事項(禁用 any、禁止硬編碼等)
- ✓ 回覆格式(語言、詳細程度)
哪裡找範本?
- cursor.directory — 可搜尋的範本目錄
- awesome-cursorrules — GitHub 大型範本集
把 .cursorrules 加入 Git,讓整個團隊共用相同的 AI 規範。
第 6 張|進階整合
MCP 工具整合
透過 Model Context Protocol,讓 AI 連接外部工具:
- Filesystem:讀寫本地檔案
- GitHub:操作 PR、Issues
- Postgres:查詢資料庫
- Brave Search:搜尋即時資訊
隱私保護
- Business 方案:隱私模式,程式碼不用於訓練
- BYOK:使用自己的 API 金鑰
.cursorignore:排除敏感檔案索引
搭配 Claude Code
Cursor 負責日常開發,Claude Code 負責大型自動化任務。兩者互補,不互斥。