---
title: "Agent、Tab、網路和效能排障"
description: "把 Cursor Agent、Tab、安裝啟動、網路代理、SSH/VPN、擴充套件衝突和效能問題整理成一套分診樹。"
verifiedAt: "2026-05-09"
---
這是 Cursor Help/Troubleshooting 的收束頁：當使用者只說“Cursor 不行”“Agent 亂改”“Tab 沒了”“聯網失敗”“很卡”時，用它把問題拆成可驗證的排障路徑。

> [!NOTE]
> **核驗日期**：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` 下行為不同，可在命令前取消它：

```bash
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：

```text
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，被誤判成模型慢。
- 擴充套件衝突沒有用無擴充套件模式驗證。

## 官方來源

- [https://cursor.com/help/troubleshooting/agent-issues.md](https://cursor.com/help/troubleshooting/agent-issues.md)
- [https://cursor.com/help/troubleshooting/tab-issues.md](https://cursor.com/help/troubleshooting/tab-issues.md)
- [https://cursor.com/help/troubleshooting/install-issues.md](https://cursor.com/help/troubleshooting/install-issues.md)
- [https://cursor.com/help/troubleshooting/network.md](https://cursor.com/help/troubleshooting/network.md)
- [https://cursor.com/help/troubleshooting/extensions.md](https://cursor.com/help/troubleshooting/extensions.md)
- [https://cursor.com/help/troubleshooting/performance.md](https://cursor.com/help/troubleshooting/performance.md)

## 接下來去哪

<Cards>
  <Card title="返回官方教程目錄" description="繼續按能力域查 Cursor 官方資料" href="/zh-Hant/docs/cursor/official" />
  <Card title="安裝與首專案" description="從第一天驗收開始排查" href="/zh-Hant/docs/cursor/official/07-help-troubleshooting/100-install-first-project" />
  <Card title="網路配置" description="企業代理和 streaming 深入排查" href="/zh-Hant/docs/cursor/official/06-teams-enterprise/86-network-configuration" />
</Cards>
