網路相關問題
Cursor Settings
> Network
並點擊 Run Diagnostics
。這會測試到 Cursor 伺服器的連線,協助找出可能影響 AI 功能、更新或其他線上功能的網路相關問題。
Cursor 的 AI 功能仰賴 HTTP/2,因為它能有效處理串流回應。如果你的網路不支援 HTTP/2,可能會遇到索引失敗和 AI 功能異常。
這種情況常見於企業網路、VPN,或使用像 Zscaler 這類代理時。
要解決這個問題,請在應用程式設定(不是 Cursor 設定)啟用 HTTP/1.1 後援:按 CMD/CTRL + ,
,搜尋 HTTP/2
,再啟用 Disable HTTP/2
。這會強制使用 HTTP/1.1,並解決問題。
我們計畫加入自動偵測與自動後援。
資源相關問題(CPU、RAM 等)
如果你在 macOS 上看到低 RAM 警示,請注意部分使用者會遇到顯示嚴重失準數值的錯誤。若是如此,請開啟「活動監視器」並查看「記憶體」分頁以確認正確的記憶體使用量。
檢查你的擴充套件
檢查你的擴充套件
擴充套件可能影響效能。Extension Monitor 會顯示所有已安裝與內建擴充套件的資源消耗。從
Settings
> Application
> Experimental
啟用擴充監視器,切換 Extension Monitor: Enabled
。這會要求你重新啟動 Cursor。開啟方式:Cmd/Ctrl + Shift + P
→ Developer: Open Extension Monitor
。Cursor 會在一個或多個 extension hosts 中執行你的擴充套件。通常,大多數擴充會在同一個 extension host 中執行,這代表某個擴充如果吃掉大量 CPU 時間,可能會讓旁邊的擴充也跟著喘不過氣!Extension Monitor 會顯示:- 每個由擴充啟動的長時間存活程序(僅限 macOS 與 Linux)。
- % Ext Host:此擴充消耗的 extension host 總時間百分比,用來找出相對於其他擴充最耗時的元兇。
- Max Blocking:每個監控區間內,該擴充連續執行的最長阻塞時間。
- % CPU:
- 針對擴充套件:歸因於該擴充程式碼的 CPU 使用率百分比。
- 針對程序:歸因於該啟動程序的 CPU 使用率百分比(僅限 macOS 與 Linux)。
- Memory:
- 針對擴充套件:該擴充程式碼使用的 JS heap 記憶體(不含外部配置)。
- 針對程序:該啟動程序使用的系統記憶體(僅限 macOS 與 Linux)。
cursor --disable-extensions
來測試。若效能改善,請逐一重新啟用擴充以找出問題來源。試試 Extension Bisect 來辨識有問題的擴充。進一步閱讀這裡。注意:這最適合用於立即發生的問題,而非逐步惡化的效能問題。使用 Process Explorer
使用 Process Explorer
Process Explorer 會顯示哪些程序在消耗資源。開啟方式:指令面板(
Cmd/Ctrl + Shift + P
)→ Developer: Open Process Explorer
。檢視以下程序:extensionHost
:與擴充相關的問題ptyHost
:終端機資源消耗
監控系統資源
監控系統資源
使用作業系統的監控工具來判斷問題是 Cursor 特有,還是全系統性的。
測試最小化安裝
測試最小化安裝
如果問題持續,試試最小化的 Cursor 安裝來測試。
一般常見問題
我在變更日誌看到更新,但 Cursor 沒有更新
我在變更日誌看到更新,但 Cursor 沒有更新
新版會採分階段推出——會先隨機推送給部分使用者。通常幾天內就會收到更新。
我在 Cursor 的 GitHub 登入有問題/如何在 Cursor 登出 GitHub?
我在 Cursor 的 GitHub 登入有問題/如何在 Cursor 登出 GitHub?
在指令選單
Ctrl/⌘ + Shift + P
執行 Sign Out of GitHub
。我無法使用 GitHub Codespaces
我無法使用 GitHub Codespaces
目前尚未支援 GitHub Codespaces。
連線到 Remote SSH 時發生錯誤
連線到 Remote SSH 時發生錯誤
目前不支援連到 Mac 或 Windows 機器的 SSH。其他問題請連同日誌回報到 forum。
Windows 上的 SSH 連線問題
Windows 上的 SSH 連線問題
如果你看到「SSH is only supported in Microsoft versions of VS Code」:
-
解除安裝 Remote-SSH:
- 開啟擴充功能檢視 (
Ctrl + Shift + X
) - 搜尋「Remote-SSH」
- 點齒輪圖示 →「Uninstall」
- 開啟擴充功能檢視 (
-
安裝 Anysphere Remote SSH:
- 開啟 Cursor marketplace
- 搜尋「SSH」
- 安裝 Anysphere Remote SSH 擴充功能
-
安裝後:
- 關閉所有有啟用 SSH 連線的 VS Code 執行個體
- 重新啟動 Cursor
- 透過 SSH 重新連線
在公司代理伺服器後面 Cursor Tab 和 Inline Edit 無法運作
在公司代理伺服器後面 Cursor Tab 和 Inline Edit 無法運作
Cursor Tab 與 Inline Edit 使用 HTTP/2 以降低延遲與資源使用。部分企業代理(例如 Zscaler)會封鎖 HTTP/2。可在設定中將
"cursor.general.disableHttp2": true
(Cmd/Ctrl + ,
,搜尋 http2
)來修正。我剛訂閱 Pro,但在 app 內仍然是免費方案
我剛訂閱 Pro,但在 app 內仍然是免費方案
從 Cursor 設定登出後再登入。
我的使用量何時會重置?
我的使用量何時會重置?
Pro 訂閱者:在 Dashboard 點擊
Manage Subscription
查看續訂日期。免費使用者:查看你收到第一封 Cursor 信件的日期。使用量會自該日期起每月重置。更新後我的 Chat/Composer 歷史紀錄消失了
更新後我的 Chat/Composer 歷史紀錄消失了
磁碟空間不足可能會導致 Cursor 在更新時清除歷史資料。為避免此情況:
- 更新前維持足夠的可用磁碟空間
- 定期清理不必要的系統檔案
- 更新前先備份重要對話
如何解除安裝 Cursor?
如何解除安裝 Cursor?
依照這份指南操作。將文中的「VS Code」或「Code」替換為「Cursor」,並將「.vscode」替換為「.cursor」。
如何刪除我的帳戶?
如何刪除我的帳戶?
在 Dashboard 點擊
Delete Account
。這會永久刪除你的帳戶與所有相關資料。如何從指令列開啟 Cursor?
如何從指令列開啟 Cursor?
在終端機執行
cursor
。如果沒有這個指令:- 開啟指令選單
⌘⇧P
- 輸入
install command
- 選擇
Install 'cursor' command
(也可選擇安裝code
指令覆蓋 VS Code)
無法登入 Cursor
無法登入 Cursor
如果點擊 Sign In 跳轉到 cursor.com 但沒有成功登入,先停用防火牆或防毒軟體——它們可能阻擋了登入流程。
可疑活動訊息
可疑活動訊息
近期濫用情形增加,你的請求可能因安全措施被封鎖。可這樣處理:先檢查你的 VPN。如果有在用,試著關閉,因為 VPN 有時會觸發我們的安全系統。如果還是不行,可以嘗試:
- 建立新的聊天
- 等一段時間再試
- 使用 Google 或 GitHub 驗證建立新帳號
- 升級到 Cursor Pro