AI 程式設計教程中文版
官方教程中文版Help Center 與排障

Agent、Tab、網路和效能排障

把 Cursor Agent、Tab、安裝啟動、網路代理、SSH/VPN、擴充套件衝突和效能問題整理成一套分診樹。

這是 Cursor Help/Troubleshooting 的收束頁：當使用者只說“Cursor 不行”“Agent 亂改”“Tab 沒了”“聯網失敗”“很卡”時，用它把問題拆成可驗證的排障路徑。

核驗日期：2026-05-06。Agent、Tab、HTTP Compatibility Mode、網路診斷、擴充套件和效能建議會隨客戶端變化；排障前按官方 Help Center 複核。

1. 一句話判斷

先不要重灌。按順序判斷：是 Agent 上下文問題、Tab 服務問題、網路 streaming 問題、擴充套件衝突、版本/安裝問題，還是機器資源問題。

同一個症狀可能有不同根因。例如 “Agent 很慢” 可能是網路代理，也可能是索引、模型用量、遠端 SSH、擴充套件或任務太大。

2. Agent 排障

Agent 不準確

官方建議：

  • prompt 要具體，包含 expected behavior 和 constraints。
  • 多檔案任務先用 Plan mode。
  • 完成一個 feature 或切換任務時開新 chat。
  • 把穩定專案模式寫進 .cursor/rules/。
  • 用 @file 或 @folder 給 Agent 定向上下文。

本地補充判斷：

  • 如果 Agent 總找錯檔案，先查 indexing、ignore files、專案根目錄是否開啟正確。
  • 如果 Agent 總違反團隊約束，先查 Rules、AGENTS.md、CLAUDE.md。
  • 如果 Agent 反覆跑錯命令，先查終端審批、hooks 和專案指令碼。

Agent 找不到檔案

按順序查：

  1. .cursorignore 是否排除了目標檔案。
  2. .gitignore 是否間接影響發現。
  3. 是否需要 Reindex。
  4. 是否可以用 @filename 直接附加檔案。
  5. 是否開啟了父目錄或錯誤 workspace。

Agent 改壞了

官方說明可在歷史訊息右下角使用 Restore Checkpoint 回復該點之後 Agent 做的改動。Checkpoint 存在本地，和 git 分開；長期版本控制仍然用 git。

Agent 終端行為異常

官方說明 Agent 執行 terminal commands 時會設定 CI=1，讓工具輸出更乾淨。如果專案在 CI=1 下行為不同，可在命令前取消它：

unset CI && your-command

也可以寫進 project rule，提醒 Agent 對特定命令加字首。

報告壞回覆

官方要求：

  1. 點選回覆底部的 ...。
  2. 選擇 Copy Request ID。
  3. 到 forum.cursor.com 提供 request ID、復現步驟和 system info。
  4. system info 在 macOS 的 Cursor > About Cursor，Windows/Linux 的 Help > About。

3. Tab 排障

Tab 不出現

官方排查順序：

  • Hobby 使用者是否用完 monthly Tab allowance。
  • 企業網路是否阻斷 HTTP/2。
  • Cursor 是否過舊，需要 Cursor: Attempt Update。
  • 裝置是否斷網。

如果網路阻斷 HTTP/2，在 Cursor Settings 搜尋 HTTP Compatibility Mode，切到 HTTP/1.1，並重啟 Cursor。

Tab 質量差

Tab 基於 recent edits、cursor 周圍程式碼和 linter errors。新檔案或空檔案上下文少，建議先手寫幾處意圖明確的程式碼。

如果建議一直怪異，查：

  • 是否有其他 AI coding assistant extension。
  • 是否有快捷鍵衝突。
  • 當前檔案型別是否應關閉 Tab。
  • Tab 是否被右下角 status indicator 暫停或按副檔名停用。

Tab 很慢

先查：

  • 網路連線。
  • VPN / proxy 延遲。
  • 擴充套件衝突。
  • 是否需要更新 Cursor。

4. 網路、代理、SSH 和 VPN

網路診斷

官方入口：Cursor Settings > Network > Run Diagnostics。它會測試到 Cursor servers 的連線，定位影響 AI features 或 updates 的問題。

代理和 HTTP/2

Cursor 使用 HTTP/2 streaming。企業代理，尤其是部分 Zscaler 配置，可能阻斷 HTTP/2。

使用者側臨時處理：

  • Cursor Settings > Network。
  • HTTP Compatibility Mode 設為 HTTP/1.1。
  • 重啟 Cursor。

企業側要回到 86 頁處理 allowlist、SSL inspection、SSE passthrough 和長連線。

需要放行的官方域名：

  • *.cursor.sh
  • *.cursor-cdn.com
  • *.cursorapi.com

SSH / remote connections

官方說明：使用 Cursor Remote SSH extension 時，AI requests 從本地機器發往 Cursor servers，不是從 remote host 發出。

排查順序：

  • 本地網路是否正常。
  • remote server 是否 CPU 或記憶體耗盡。
  • SSH 是否頻繁斷開。
  • 斷開後是否重啟 Cursor，清理 stale processes。

如果 SSH 經常斷，可增加 SSH keep-alive：

ServerAliveInterval 60
ServerAliveCountMax 3

VPN 和 DNS

VPN 斷開後 Cursor 可能繼承之前的 DNS 設定。AI features 或 agents 報 DNS errors 時：

  1. 完全退出並重啟 Cursor。
  2. macOS 用 scutil --dns 檢查系統 DNS。
  3. Linux 檢查 /etc/resolv.conf。

Suspicious activity

官方說明該訊息表示請求被安全措施阻斷，VPN 有時會觸發。先關 VPN；仍不行時開新 chat、等待幾分鐘，或換 Google/GitHub 認證方式登入。

5. 安裝、擴充套件和效能

啟動白屏或安裝異常

官方建議：

  • 退出並重啟 Cursor。
  • Mac：移到 Trash 後從 cursor.com/download 重灌。
  • Windows：以 administrator 執行。
  • command palette 執行 Clear Editor History。
  • 更新時用 Cmd/Ctrl+Shift+P 搜尋 Cursor: Attempt Update。

擴充套件衝突

官方排查：

  1. command palette 搜尋 Disable All Installed Extensions。
  2. 看問題是否消失。
  3. 逐個重新啟用擴充套件找衝突。

最常見衝突來源是其他 AI coding assistants，或會攔截快捷鍵的擴充套件。

效能差、CPU 或記憶體高

官方建議：

  • 停用不需要的擴充套件。
  • 用 cursor --disable-extensions 測試無擴充套件模式。
  • 把 dist/、build/、.next/ 等 generated folders 加進 .cursorignore。
  • 確保 node_modules 等依賴目錄在 .gitignore 中。

6. 一線支援分診清單

每次接問題先收集：

  • Cursor version 和 OS。
  • 問題入口：Agent、Tab、network、SSH、VPN、extensions、performance、install。
  • 是否企業裝置、是否代理、VPN、Zscaler、MDM。
  • 當前模型和賬號計劃。
  • 是否新 chat 復現。
  • 是否能在無擴充套件模式復現。
  • 是否能在非 VPN 網路復現。
  • request ID、截圖、日誌、terminal output。

7. 商業級驗收

  • Agent 問題能區分上下文、規則、索引、終端、模型和網路。
  • Tab 問題能區分 allowance、HTTP/2、版本、網路和擴充套件。
  • 網路問題能跑 Run Diagnostics，並知道 HTTP Compatibility Mode。
  • SSH 問題知道 AI requests 從本地機器發出。
  • VPN/DNS 問題知道要完整重啟 Cursor。
  • 擴充套件和效能問題能用停用擴充套件方式復現。
  • 可轉交問題包含 request ID 和 system info。

8. 常見失敗點

  • 一上來重灌，不先分診。
  • Agent 不讀檔案時只改 prompt，不查 .cursorignore 和 indexing。
  • Tab 不出現時不看計劃 allowance 和 HTTP compatibility。
  • 遠端 SSH 出問題時誤查 remote host 到 Cursor 的網路。
  • 代理緩衝 streaming，被誤判成模型慢。
  • 擴充套件衝突沒有用無擴充套件模式驗證。

官方來源

接下來去哪

返回官方教程目錄

繼續按能力域查 Cursor 官方資料

安裝與首專案

從第一天驗收開始排查

網路配置

企業代理和 streaming 深入排查

賬號與賬單排障

把 Cursor billing cycle、included usage、on-demand、seat、invoice、payment、cancel、refund 整理成可轉交的賬務排障流程。

本頁目錄

1. 一句話判斷2. Agent 排障Agent 不準確Agent 找不到檔案Agent 改壞了Agent 終端行為異常報告壞回覆3. Tab 排障Tab 不出現Tab 質量差Tab 很慢4. 網路、代理、SSH 和 VPN網路診斷代理和 HTTP/2SSH / remote connectionsVPN 和 DNSSuspicious activity5. 安裝、擴充套件和效能啟動白屏或安裝異常擴充套件衝突效能差、CPU 或記憶體高6. 一線支援分診清單7. 商業級驗收8. 常見失敗點官方來源接下來去哪