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

打开“应用程序”文件夹,右键点击“Cursor”,选择“移到废纸篓”。

Linux

对于 .deb 包: sudo apt remove cursor对于 .rpm 包: sudo dnf remove cursorsudo yum remove cursor对于 AppImage: 删除所在位置的 Cursor.appimage 文件。
5

重新安装 Cursor

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

报告问题

如果这些步骤仍然无效,去论坛反馈。

Cursor Forum

在 Cursor 论坛报告 Bug 或问题
为便于快速排查,请提供:

问题截图

截取屏幕,并打码/遮盖敏感信息。

复现步骤

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

系统信息

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

请求 ID

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

控制台错误

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

日志

打开日志:
Developer: Open Logs Folder