以下是常見問題與其解法。

網路相關問題

先檢查網路連線。前往 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 等)

高 CPU 或 RAM 使用率可能會讓機器變慢或觸發資源警示。 雖然大型程式碼庫需要更多資源,但高使用率通常來自擴充套件或設定問題。
如果你在 macOS 上看到低 RAM 警示,請注意部分使用者會遇到顯示嚴重失準數值的錯誤。若是如此,請開啟「活動監視器」並查看「記憶體」分頁以確認正確的記憶體使用量。
如果遇到高 CPU 或 RAM 使用率,試試以下步驟:
擴充套件可能影響效能。Extension Monitor 會顯示所有已安裝與內建擴充套件的資源消耗。Settings > Application > Experimental 啟用擴充監視器,切換 Extension Monitor: Enabled。這會要求你重新啟動 Cursor。開啟方式:Cmd/Ctrl + Shift + PDeveloper: Open Extension MonitorCursor 會在一個或多個 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 會顯示哪些程序在消耗資源。開啟方式:指令面板(Cmd/Ctrl + Shift + P)→ Developer: Open Process Explorer檢視以下程序:
  • extensionHost:與擴充相關的問題
  • ptyHost:終端機資源消耗
Process Explorer 會顯示每個終端與其執行中的指令,方便診斷。對於其他高使用率的程序,請回報到論壇
使用作業系統的監控工具來判斷問題是 Cursor 特有,還是全系統性的。
如果問題持續,試試最小化的 Cursor 安裝來測試。

一般常見問題

新版會採分階段推出——會先隨機推送給部分使用者。通常幾天內就會收到更新。
在指令選單 Ctrl/⌘ + Shift + P 執行 Sign Out of GitHub
目前尚未支援 GitHub Codespaces。
目前不支援連到 Mac 或 Windows 機器的 SSH。其他問題請連同日誌回報到 forum
如果你看到「SSH is only supported in Microsoft versions of VS Code」:
  1. 解除安裝 Remote-SSH:
    • 開啟擴充功能檢視 (Ctrl + Shift + X)
    • 搜尋「Remote-SSH」
    • 點齒輪圖示 →「Uninstall」
  2. 安裝 Anysphere Remote SSH:
    • 開啟 Cursor marketplace
    • 搜尋「SSH」
    • 安裝 Anysphere Remote SSH 擴充功能
  3. 安裝後:
    • 關閉所有有啟用 SSH 連線的 VS Code 執行個體
    • 重新啟動 Cursor
    • 透過 SSH 重新連線
請確認你的 SSH 設定與金鑰已正確設定。
Cursor Tab 與 Inline Edit 使用 HTTP/2 以降低延遲與資源使用。部分企業代理(例如 Zscaler)會封鎖 HTTP/2。可在設定中將 "cursor.general.disableHttp2": trueCmd/Ctrl + ,,搜尋 http2)來修正。
從 Cursor 設定登出後再登入。
Pro 訂閱者:在 Dashboard 點擊 Manage Subscription 查看續訂日期。免費使用者:查看你收到第一封 Cursor 信件的日期。使用量會自該日期起每月重置。
磁碟空間不足可能會導致 Cursor 在更新時清除歷史資料。為避免此情況:
  1. 更新前維持足夠的可用磁碟空間
  2. 定期清理不必要的系統檔案
  3. 更新前先備份重要對話
依照這份指南操作。將文中的「VS Code」或「Code」替換為「Cursor」,並將「.vscode」替換為「.cursor」。
Dashboard 點擊 Delete Account。這會永久刪除你的帳戶與所有相關資料。
在終端機執行 cursor。如果沒有這個指令:
  1. 開啟指令選單 ⌘⇧P
  2. 輸入 install command
  3. 選擇 Install 'cursor' command(也可選擇安裝 code 指令覆蓋 VS Code)
如果點擊 Sign In 跳轉到 cursor.com 但沒有成功登入,先停用防火牆或防毒軟體——它們可能阻擋了登入流程。
近期濫用情形增加,你的請求可能因安全措施被封鎖。可這樣處理:先檢查你的 VPN。如果有在用,試著關閉,因為 VPN 有時會觸發我們的安全系統。如果還是不行,可以嘗試:
  • 建立新的聊天
  • 等一段時間再試
  • 使用 Google 或 GitHub 驗證建立新帳號
  • 升級到 Cursor Pro