官方教程中文版Help Center 與排障
幫助與排障
幫助與排障相關的 Cursor 官方教程中文版。
當 Cursor 行為和預期不一致時，先分層定位：賬號、網路、專案索引、模型用量、工具許可權、編輯器狀態還是雲端任務。這一組是 Cursor 的排障層——Help Center、故障頁、網路頁、Agent Tab、賬號計費和模型用量頁用來定位真實問題。
閱讀方式：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。
安裝和第一個專案排障
Help Center 中的安裝、第一專案、遷移入口。
AI Features Help
Agent、Ask、Plan、Debug、Tab、Inline Edit 等功能入口。
Customization Help
Rules、Context、MCP、Skills、Indexing、Ignore files。
Models and Usage Help
模型、API keys、usage limits、token rate。
Security and Privacy Help
隱私、區域、合規、SSO、Marketplace security。
Account and Billing Help
賬單、發票、超額、支付、取消和退款。
Agent、Tab、網路和效能排障
常見 Agent、Tab、安裝、網路、擴充套件和效能問題。
排障順序
Cursor 出問題時，不要直接重灌。先按層定位：
- 賬號和計費：是否登入、是否有用量、是否觸發 limits。
- 網路：企業代理、VPN、防火牆、DNS 是否攔截。
- 專案索引：
.cursorignore、.gitignore、semantic search、Reindex 是否影響檔案發現。 - Agent 上下文：prompt 是否具體，是否使用 Plan Mode，是否用
@file指定檔案。 - 工具許可權：terminal、browser、MCP、extensions 是否被限制。
- 雲端任務：Cloud Agent、Bugbot、Slack 或 GitHub 是否選錯 repo/branch。
- 效能：遠端連線、本地資源、擴充套件衝突和快取。
這個順序能避免把網路問題誤判成模型問題，也能避免把 .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 修自己。
排障頁的目標是縮小問題面，而不是列所有可能原因。