故障排查指南

本指南帮助你排查和解决 Cursor 常见问题,包括重置应用数据和提交详细的 bug 报告。

有时 Cursor 可能会出现一些意外问题,可能与扩展、应用数据或你的系统有关。我们一直在努力提升 Cursor 的稳定性,如果遇到问题,可以尝试以下步骤:

故障排查

扩展数据

如果你遇到单个扩展的问题,可以尝试卸载并重新安装该扩展,以重置其存储的数据。也请检查设置中是否有相关扩展的配置,这些配置在卸载重装后可能会保留。

清除应用数据

警告:
此操作会删除你的应用数据,包括扩展、主题、代码片段及所有与安装相关的数据。建议先导出你的配置文件以防数据丢失。

为了让你的安装在更新或重装后能够恢复,Cursor 会将应用数据保存在应用本体之外。这意味着即使你卸载 Cursor,重新安装后也能恢复之前的应用数据。

如果你想彻底清除应用数据,可以按以下步骤操作:

  • Windows:
    在命令提示符运行:

    rd /s /q %USERPROFILE%\AppData\Local\Programs\cursor*
    rd /s /q %USERPROFILE%\AppData\Local\Cursor*
    rd /s /q %USERPROFILE%\AppData\Roaming\Cursor*
    rd /s /q %USERPROFILE%\cursor*
    
  • MacOS:
    在终端运行:

    sudo rm -rf ~/Library/Application\ Support/Cursor
    rm -f ~/.cursor.json
    
  • Linux:
    在终端运行:

    rm -rf ~/.cursor ~/.config/Cursor/
    

卸载Cursor

虽然我们不希望你需要重装 Cursor,但如果遇到问题,这有时确实能帮助解决。

卸载 Cursor 应用的方法如下:

Windows:
在开始菜单搜索“添加或删除程序”,找到“Cursor”,点击“卸载”
MacOS:
打开“应用程序”文件夹,找到“Cursor”,右键选择“移到废纸篓”。
Linux:
找到 Cursor.appimage 文件并删除即可。

4. 重新安装 Cursor

卸载后,可前往 下载页面 获取最新版重新安装。如果未清除应用数据,安装后会恢复到卸载前的状态;如已清除,则为全新安装。

报告问题

如果上述方法无效,请在 Cursor 论坛 反馈,我们会协助你诊断问题。

为便于快速定位和解决问题,请尽量提供以下信息:

问题截图
截图并打码敏感信息
复现步骤
详细描述如何复现问题
系统信息
获取方式:Cursor > Help > About
请求 ID
点击查看如何收集请求 ID 的指南
控制台错误
在命令面板运行 `Developer: Toggle Developer Tools` 查看开发者工具控制台错误
日志
在命令面板运行 `Developer: Open Logs Folder` 获取 Cursor 日志