Cursor 的問題可能來自擴充功能、應用程式資料,或系統層面的狀況。先試試這些疑難排解步驟。

疑難排解

1

Check network connectivity

先確認 Cursor 能否連線到相關服務。執行網路診斷: 前往 Cursor Settings > Network,點擊 Run Diagnostics。這會測試你與 Cursor 伺服器的連線,並找出影響 AI 功能、更新或其他線上功能的網路問題。如果診斷顯示連線異常,檢查防火牆、代理伺服器設定,或任何可能阻擋 Cursor 存取的網路限制。
2

Clearing extension data

如果遇到擴充功能的問題:暫時停用所有擴充功能: 從命令列執行 cursor --disable-extensions。如果問題消失,請逐一重新啟用擴充功能以找出問題來源。重設擴充功能資料: 解除安裝並重新安裝有問題的擴充功能以重設其儲存資料。也檢查是否有在重新安裝後仍會保留的擴充功能設定。
3

Clearing app data

這會刪除你的應用程式資料,包括擴充功能、佈景主題、程式碼片段,以及與安裝相關的資料。請先匯出你的個人設定檔以保留這些資料。
Cursor 會將應用程式資料存放在主程式之外,以便在更新或重新安裝後復原。要清除應用程式資料:Windows: 在命令提示字元執行以下指令:
rd /s /q "%USERPROFILE%\AppData\Local\Programs\Cursor"
rd /s /q "%USERPROFILE%\AppData\Local\Cursor"
rd /s /q "%USERPROFILE%\AppData\Roaming\Cursor"
del /f /q "%USERPROFILE%\.cursor*"
rd /s /q "%USERPROFILE%\.cursor"
macOS: 在 Terminal 執行 sudo rm -rf ~/Library/Application\ Support/Cursorrm -f ~/.cursor.jsonLinux: 在 Terminal 執行 rm -rf ~/.cursor ~/.config/Cursor/
4

Uninstalling Cursor

要解除安裝 Cursor:

Windows

在開始選單搜尋「Add or Remove Programs」,找到「Cursor」,點擊「Uninstall」。

macOS

開啟 Applications 資料夾,右鍵點擊「Cursor」,選擇「Move to Trash」。

Linux

.deb 套件: sudo apt remove cursor.rpm 套件: sudo dnf remove cursorsudo yum remove cursorAppImage: 直接刪除該位置的 Cursor.appimage 檔案。
5

Reinstalling Cursor

下載頁面 重新安裝。若未清除應用程式資料,Cursor 會還原到先前狀態;否則會是全新安裝。

回報問題

如果以上步驟仍無法解決,去論壇回報吧。

Cursor Forum

在 Cursor 論壇回報錯誤或問題
為了更快處理,請提供:

Screenshot of Issue

擷取問題畫面,並遮住敏感資訊。

Steps to Reproduce

詳列可重現問題的具體步驟。

System Information

取得系統資訊:
Cursor > Help > About

Request IDs

點此查看如何蒐集 Request ID 的指南

Console Errors

檢查開發者主控台:
Developer: Toggle Developer Tools

Logs

存取日誌:
Developer: Open Logs Folder