Cursor 的问题可能源自扩展、应用数据或系统层面。先试试这些故障排查步骤。

疑难解答

1

检查网络连接

先检查 Cursor 是否能正常连接到其服务。运行网络诊断: 前往 Cursor Settings > Network,点击 Run Diagnostics。这会测试你与 Cursor 服务器的连接,并定位影响 AI 功能、更新或其他在线功能的网络问题。如果诊断显示连接问题,检查防火墙设置、代理配置,或可能阻止 Cursor 访问的网络限制。
2

清除扩展数据

如果是扩展相关问题:临时禁用所有扩展: 在命令行运行 cursor --disable-extensions。如果问题消失,逐个重新启用扩展以定位问题扩展。重置扩展数据: 卸载并重新安装问题扩展以重置其存储的数据。留意扩展在重装后仍然保留的配置项。
3

清除应用数据

这会删除你的应用数据,包括扩展、主题、代码片段以及与安装相关的数据。请先导出你的个人资料以保留这些数据。
为了在更新或重新安装时进行还原,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: 在终端中运行 sudo rm -rf ~/Library/Application\ Support/Cursorrm -f ~/.cursor.jsonLinux: 在终端中运行 rm -rf ~/.cursor ~/.config/Cursor/
4

卸载 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 cursor对于 AppImage: 删除其所在位置的 Cursor.appimage 文件。
5

重新安装 Cursor

下载页面重新安装。未清除应用数据时,Cursor 会恢复到之前的状态;否则就是全新安装。

报告问题

如果以上步骤仍无效,请到论坛反馈。

Cursor 论坛

在 Cursor 论坛提交 bug 或问题
为加快处理,请提供:

问题截图

截取屏幕并打码/隐藏敏感信息。

复现步骤

详细记录复现问题的具体步骤。

系统信息

从以下路径获取系统信息:
Cursor > Help > About

请求 ID

点击查看如何收集请求 ID 的指南

控制台报错

查看开发者控制台:
Developer: Toggle Developer Tools

日志

打开日志:
Developer: Open Logs Folder