AI 功能排障總覽

Cursor 的 AI 功能很多，但排障時先不要問“哪個功能壞了”，而要先判斷使用者當前在做什麼：要改程式碼、讀程式碼、先出方案、還是調複雜 bug。

1. 一句話判斷

大多數“Cursor 不好用”其實是模式選擇錯了：要改程式碼用 Agent，要只讀理解用 Ask，要先審方案用 Plan，要帶執行證據查 bug 用 Debug，要補全正在寫的區域性程式碼用 Tab。

先選對模式，再看上下文、索引、許可權、網路、模型用量和專案規則。

2. 模式選擇

Agent

Agent 是預設主力。官方說明它能搜尋程式碼庫、編輯多個檔案、執行終端命令，並自行修復錯誤。

適合：

• 新功能。
• 重構。
• 修 bug。
• 寫測試。
• 根據錯誤輸出繼續驗證。

入口：

• Mac：Cmd + I。
• Windows / Linux：Ctrl + I。

Agent 編輯會進入 diff view。出錯時可用 Stop 中斷，或對歷史訊息使用 Restore Checkpoint 回復。

Ask

Ask 適合只讀理解：解釋架構、追蹤呼叫鏈、定位檔案、理解錯誤背景。不要用 Ask 期待它直接改程式碼。

Plan

Plan 適合跨檔案或高風險任務。先讓 Cursor 產出方案，確認影響範圍、步驟和驗證方式，再允許執行。

Debug

Debug 適合有 runtime evidence 的問題，例如報錯、日誌、失敗測試、瀏覽器異常。給 Debug 的輸入要包含復現路徑和錯誤輸出。

Tab

Tab 是 AI autocomplete。它基於最近編輯、周圍程式碼和 linter errors 給出灰色建議。

常用操作：

• 接受完整建議：Tab。
• 拒絕：Escape 或繼續輸入。
• 逐詞接受：Mac 用 Cmd + Right；Windows / Linux 用 Ctrl + Right。
• 接受後再次按 Tab，可 jump-in-file 到預測的下一個編輯位置。
• 可在右下角 Tab status indicator 暫停、全域性關閉或按副檔名關閉。

Inline Edit

Inline Edit 適合對當前選中區域做區域性修改，不適合讓它承擔跨檔案任務。

3. AI 功能排障順序

按這個順序排：

1. 模式：是否用錯 Agent / Ask / Plan / Debug / Tab。
2. 上下文：是否開啟正確 folder，是否用 @file / @folder 指定了關鍵檔案。
3. 索引：codebase indexing 是否完成或需要 reindex。
4. 規則：Rules、AGENTS.md、CLAUDE.md 是否誤導了 Agent。
5. 許可權：終端命令、檔案讀取、MCP、瀏覽器工具是否被拒絕。
6. 網路：streaming、代理、SSL inspection 是否影響響應。
7. 模型與用量：模型是否可用、是否達到 limit、是否被企業策略限制。

4. 給 Agent 的任務格式

一個可執行請求應該包含：

• 目標：要改什麼。
• 範圍：哪些檔案或模組。
• 約束：不要改什麼，必須保留什麼。
• 驗證：跑什麼測試、看哪個頁面、檢查什麼日誌。
• 回退：失敗後如何撤回。

壞請求：

“最佳化一下專案。”

好請求：

“在登入頁增加郵箱格式校驗，只改 src/auth 和登入表單元件。完成後跑現有表單測試，並列出 diff 裡新增的校驗分支。”

5. 商業級驗收

• 使用者知道 Agent / Ask / Plan / Debug / Tab 的邊界。
• Agent 任務能產生可審查 diff。
• 高風險改動先用 Plan。
• 複雜 bug 用 Debug，並提供日誌或復現步驟。
• Tab 能被接受、拒絕、暫停和按檔案型別關閉。
• 失敗時能 Stop、Restore Checkpoint 或回退 diff。
• 模式問題、上下文問題、網路問題、模型用量問題能分開排查。

6. 常見失敗點

• 用 Ask 提需求，期待它自動改檔案。
• 用 Agent 問大範圍問題，沒有指定檔案、約束和驗證。
• Tab 頻繁干擾但不知道從 status indicator 關閉。
• 把模型 limit、網路 streaming 或企業許可權問題誤判為功能 bug。
• 切換任務不新開 chat，導致舊上下文汙染。

官方來源

• https://cursor.com/help/ai-features/agent.md
• https://cursor.com/help/ai-features/ask-mode.md
• https://cursor.com/help/ai-features/plan-mode.md
• https://cursor.com/help/ai-features/debug-mode.md
• https://cursor.com/help/ai-features/tab.md
• https://cursor.com/help/ai-features/inline-edit.md

接下來去哪