---
title: "AI 功能排障總覽"
description: "把 Agent、Ask、Plan、Debug、Tab、Inline Edit 的官方入口整理成模式選擇、驗證和排障路徑。"
verifiedAt: "2026-05-09"
---
Cursor 的 AI 功能很多，但排障時先不要問“哪個功能壞了”，而要先判斷使用者當前在做什麼：要改程式碼、讀程式碼、先出方案、還是調複雜 bug。

> [!NOTE]
> **核驗日期**：2026-05-06。Agent、Ask、Plan、Debug、Tab、Inline Edit 的入口、快捷鍵和能力會隨 Cursor 版本變化；支援文件按官方 Help Center 複核。

## 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/agent.md)
- [https://cursor.com/help/ai-features/ask-mode.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/plan-mode.md)
- [https://cursor.com/help/ai-features/debug-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/tab.md)
- [https://cursor.com/help/ai-features/inline-edit.md](https://cursor.com/help/ai-features/inline-edit.md)

## 接下來去哪

<Cards>
  <Card title="繼續下一頁" description="102-customization-help" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/102-customization-help" />
  <Card title="Agent 工作流" description="繼續看 Agent 如何讀寫和驗證" href="/zh-Hant/docs/cursor/official/01-agent-workflow/10-agent-overview" />
  <Card title="模式理解篇" description="把各模式放進真實開發流程" href="/zh-Hant/docs/cursor/understanding/04-agent-plan-ask-debug-tab" />
</Cards>
