---
title: "幫助與排障"
description: "幫助與排障相關的 Cursor 官方教程中文版。"
verifiedAt: "2026-05-09"
---

當 Cursor 行為和預期不一致時，先分層定位：賬號、網路、專案索引、模型用量、工具許可權、編輯器狀態還是雲端任務。這一組是 Cursor 的排障層——Help Center、故障頁、網路頁、Agent Tab、賬號計費和模型用量頁用來定位真實問題。

> [!NOTE]
> **閱讀方式**：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。

<Cards>
  <Card title="安裝和第一個專案排障" description="Help Center 中的安裝、第一專案、遷移入口。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/100-install-first-project" />
  <Card title="AI Features Help" description="Agent、Ask、Plan、Debug、Tab、Inline Edit 等功能入口。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/101-ai-features-overview" />
  <Card title="Customization Help" description="Rules、Context、MCP、Skills、Indexing、Ignore files。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/102-customization-help" />
  <Card title="Models and Usage Help" description="模型、API keys、usage limits、token rate。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/103-models-usage-help" />
  <Card title="Security and Privacy Help" description="隱私、區域、合規、SSO、Marketplace security。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/104-security-privacy-help" />
  <Card title="Account and Billing Help" description="賬單、發票、超額、支付、取消和退款。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/105-account-billing-help" />
  <Card title="Agent、Tab、網路和效能排障" description="常見 Agent、Tab、安裝、網路、擴充套件和效能問題。" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/106-troubleshooting-agent-tab-network" />
</Cards>

## 排障順序

Cursor 出問題時，不要直接重灌。先按層定位：

1. 賬號和計費：是否登入、是否有用量、是否觸發 limits。
2. 網路：企業代理、VPN、防火牆、DNS 是否攔截。
3. 專案索引：`.cursorignore`、`.gitignore`、semantic search、Reindex 是否影響檔案發現。
4. Agent 上下文：prompt 是否具體，是否使用 Plan Mode，是否用 `@file` 指定檔案。
5. 工具許可權：terminal、browser、MCP、extensions 是否被限制。
6. 雲端任務：Cloud Agent、Bugbot、Slack 或 GitHub 是否選錯 repo/branch。
7. 效能：遠端連線、本地資源、擴充套件衝突和快取。

這個順序能避免把網路問題誤判成模型問題，也能避免把 `.cursorignore` 導致的上下文缺失誤判成 Agent “不聰明”。

## 官方排障要點

官方 Help Center 裡有幾個高頻事實：

- Agent 準確性依賴具體 prompt、Plan Mode、Rules 和 `@` 檔案上下文。
- Agent 找不到檔案時，先查 `.cursorignore` 和 `.gitignore`，再 Reindex 或直接 attach 檔案。
- Agent 修改可以用 Restore Checkpoint 回退，但 checkpoint 是本地機制，不能替代 git。
- Agent terminal 預設可能帶 `CI=1`，如果專案行為受影響，可以在命令前 unset。
- 企業代理或 VPN 攔截 HTTP/2 時，可以在 Network 設定裡啟用 HTTP Compatibility Mode 到 HTTP/1.1。
- 防火牆環境要 allowlist Cursor 相關域名。
- Remote SSH 場景下 AI 請求通常從本機發出，不是從遠端主機發出。

這些都是排障時應該先確認的事實，不要靠猜。

## 提交問題的材料

如果要向團隊或官方求助，至少收集：

- Cursor 版本和系統資訊。
- Request ID 或相關任務 ID。
- 復現步驟。
- 期望行為和實際行為。
- 是否使用代理、VPN、Remote SSH、WSL 或企業網路。
- 相關 `.cursorignore`、Rules、MCP、terminal command。
- 已經嘗試過的操作，例如 Reindex、HTTP/1.1 compatibility、restart。

材料越結構化，越容易判斷是賬號、網路、索引、Agent、工具還是雲端任務問題。

## 不建議的做法

- 一齣錯就重灌編輯器。
- 把所有規則刪掉再試，導致真實邊界丟失。
- 把企業代理繞開，用個人網路驗證生產專案。
- 不看 Request ID 就把錯誤描述成“AI 不工作”。
- 沒保留失敗命令和日誌就讓 Agent 修自己。

排障頁的目標是縮小問題面，而不是列所有可能原因。

## 官方來源

- [Cursor Docs](https://cursor.com/docs)
- [Cursor llms.txt](https://cursor.com/llms.txt)
- [Cursor Help Center](https://cursor.com/help)
- [Cursor Agent troubleshooting](https://cursor.com/help/troubleshooting/agent-issues.md)
- [Cursor Network, proxy, and remote connections](https://cursor.com/help/troubleshooting/network.md)
- [Cursor Performance troubleshooting](https://cursor.com/help/troubleshooting/performance.md)
