Appearance
Cursor 变得非常卡顿、反复无响应
问题
Cursor 在使用过程中逐渐变得极度卡顿,输入响应迟缓,Agent 操作挂起,编辑器窗口频繁无响应(标题栏显示"未响应")。关闭再打开后短暂恢复,但过一段时间又恢复卡顿状态。即使电脑整体资源(CPU、内存)并不高,问题依然存在。
解决方案
这类问题通常由以下几个原因之一导致,按照排查优先级逐一检查:
1. 代码库索引失控(最常见原因)
Cursor 会对整个工作目录建立语义索引,若项目包含大量自动生成文件(node_modules、dist、build、.next、__pycache__ 等),索引进程会持续占用大量 CPU 和磁盘 I/O。
修复方法:在项目根目录创建 .cursorignore 文件(格式同 .gitignore),排除无需索引的目录:
node_modules/
dist/
.next/
build/
*.log
*.lock保存后 Cursor 会重建索引,通常在几分钟内恢复正常。
2. 扩展冲突
Cursor 基于 VS Code,若安装了大量扩展(尤其是语言服务器类扩展,如多个 ESLint/Prettier/TS 扩展同时生效),容易互相干扰。
修复方法:逐一禁用非必要扩展,观察是否恢复。重点排查最近新安装的扩展。
3. 硬件加速导致渲染异常
修复方法:打开命令面板(Ctrl+Shift+P),搜索 Disable Hardware Acceleration,重启 Cursor。
4. 重建 Cursor 索引数据库
若以上均无效,清除本地缓存数据重试:
- Windows:删除
%APPDATA%\Cursor\User\workspaceStorage\下对应项目的文件夹 - macOS:删除
~/Library/Application Support/Cursor/User/workspaceStorage/
重启 Cursor 后重新打开项目,等待索引重建完成。