故障排查指南
本指南帮助你排查和解决 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 日志