troubleshooting-guide
有时，Cursor 可能会意外出现一些问题。这可能是由多种原因引起的，包括扩展插件、应用数据或系统问题。尽管我们努力确保 Cursor 在开箱即用时尽可能稳定，但如果遇到这些问题，您可以尝试以下步骤进行排查。
故障排除
检查网络连接
在进行复杂故障排除之前，建议先确认 Cursor 是否能正常连接其服务。
运行网络诊断： 前往 Cursor 设置 > 网络 并点击 运行诊断。该操作将测试您与 Cursor 服务器的连接，帮助识别可能影响 AI 功能、更新或其他在线服务的网络问题。
若诊断显示连接问题，请检查防火墙设置、代理配置或可能阻止 Cursor 访问服务的网络限制。
清理扩展数据
若遇到个别扩展问题，可尝试以下方法：
临时禁用所有扩展： 通过命令行 运行 cursor --disable-extensions 启动 Cursor。若问题解决，请逐个重新启用扩展以定位问题扩展。
重置扩展数据： 卸载并重新安装问题扩展以清除其存储数据。同时检查设置中是否存在卸载后仍保留的扩展配置。
清理应用数据
💡 此操作将删除应用数据，包括扩展、主题、代码片段等安装相关数据。建议提前导出配置文件以防数据丢失。
Cursor 将应用数据存储在应用本体之外，以便在更新或重装时保留配置。这意味着卸载后重新安装仍可恢复原有数据。
如需清理应用数据，请按以下步骤操作：
Windows： 在命令提示符中运行以下命令：
code]:pr-[3rem] [&_pre>code>span.line-highlight]:min-w-[calc(100%+3rem)] [&_pre>code>span.line-diff]:min-w-[calc(100%+3rem)] rounded-2xl bg-white overflow-x-auto scrollbar-thin scrollbar-thumb-rounded scrollbar-thumb-black/15 hover:scrollbar-thumb-black/20 active:scrollbar-thumb-black/20 dark:scrollbar-thumb-white/20 dark:hover:scrollbar-thumb-white/25 dark:active:scrollbar-thumb-white/25" component-part="code-block-root" style="font-variant-ligatures: none; height: auto;">
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
虽然我们不希望您需要重装，但在某些情况下这可能是解决问题的有效方法。
卸载方法如下：
Windows
在开始菜单中搜索添加或删除程序，找到 "Cursor" 后点击"卸载"
MacOS
打开应用程序文件夹，右键点击 "Cursor" 并选择"移到废纸篓"
Linux
找到 Cursor.appimage 文件所在位置并删除
重新安装 Cursor
若已卸载 Cursor，请访问下载页面获取最新版本。若未清除应用数据，重装后将恢复原有配置；否则将获得全新安装环境。
提交问题报告
若上述步骤未能解决问题，请在 官方论坛 告知我们，我们将协助您诊断问题。
Cursor 论坛点击此处在 Cursor 论坛提交错误或问题
为加快问题解决进度，请尽可能提供以下信息，以便开发团队为您和其他用户快速定位问题：
问题截图
请截取问题发生时的界面截图，注意对敏感信息进行脱敏处理。
复现步骤
详细描述触发问题的具体操作步骤。
系统信息
通过以下路径获取系统信息：
Cursor > 帮助 > 关于
控制台报错
在命令面板执行以下指令查看开发者工具控制台报错：
Developer: Toggle Developer Tools
日志文件
在命令面板执行以下指令获取 Cursor 日志：
Developer: Open Logs Folder