故障排除指南

本指南提供解决常见 Cursor 问题、重置应用数据及提交详细错误报告的方法

Cursor 有时可能会意外出现问题，可能源于扩展程序、应用数据或系统环境等多种因素。虽然我们致力于确保 Cursor 开箱即用的稳定性，若遇到问题可尝试以下解决步骤。

扩展数据 应用数据 卸载指南 问题报告

故障排除

1. 扩展数据

若单个扩展程序出现问题，可尝试卸载后重新安装以重置其存储数据。同时请检查设置，确认是否存在卸载重装后仍保留的扩展配置。

2. 清除应用数据

警告：
此操作将删除所有应用数据，包括扩展程序、主题、代码片段及与安装相关的所有数据。建议提前导出配置文件以防数据丢失。

为支持版本更新和重装时的数据恢复，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/

3. 卸载 Cursor

虽然我们不希望您重装 Cursor，但遇到棘手问题时此操作可能有效。

卸载方法：

• Windows：在开始菜单搜索"添加或删除程序"，找到 Cursor 后点击"卸载"
• macOS：打开应用程序文件夹，右键单击 Cursor 并选择"移至废纸篓"
• Linux：找到 Cursor.appimage 文件位置后直接删除

4. 重装 Cursor

卸载后请访问下载页面获取最新版本。若未清除应用数据，重装后将恢复至卸载前状态；否则将获得全新安装环境。

问题报告

若上述步骤无效，请在论坛提交问题，我们将协助诊断。

为加速问题解决，请尽可能提供以下信息：

问题截图

捕获问题界面截图，注意遮蔽敏感信息

复现步骤

详细记录触发问题的操作流程

系统信息

通过以下路径获取：
Cursor > 帮助 > 关于

请求ID

查看收集请求ID的指南

控制台错误

在命令面板执行以下命令查看开发者工具控制台错误：
Developer: Toggle Developer Tools

日志文件

在命令面板执行以下命令访问日志：
Developer: Open Logs Folder