🔧 Cursor 卡顿解决方案

🏠 返回首页 📚 文档中心

📋 问题根源

Cursor 越用越慢的根本原因是本地索引污染。当你修改过项目名称或路径后，Cursor 的以下组件会出现失配：

这导致 Cursor 每次查询相关文件时反复遍历/重建/回退，表现为每次回答前卡很久。

🛠️ 解决方案：彻底清理 Cursor 本地索引

⚠️ 注意： 以下操作基于 macOS 系统，Windows 用户需要调整命令行路径。

1️⃣完全退出 Cursor

  • 菜单：Cursor → Quit Cursor
  • 确保所有窗口关闭

2️⃣删除 globalStorage

rm -f "$HOME/Library/Application Support/Cursor/User/globalStorage/storage.json"
rm -f "$HOME/Library/Application Support/Cursor/User/globalStorage/state.vscdb"*

这一步会强制 Cursor 重建全局存储数据库，通常能清掉混乱的 embedding / workspace 关联关系。

3️⃣删除所有指向当前项目的 workspaceStorage

首先找出所有引用项目名的 workspaceStorage：

grep -R -n "project-name" "$HOME/Library/Application Support/Cursor/User/workspaceStorage"/*/workspace.json

然后把命中的目录直接删除：

rm -rf "$HOME/Library/Application Support/Cursor/User/workspaceStorage/<hash>"

4️⃣删除 Cursor 生成的 worktrees

rm -rf "/Users/user/.cursor/worktrees/project-name"

避免 Apply / Agent 再指向旧 worktree。

5️⃣重新打开 Cursor（非常关键）

  • ✅ 只打开真实仓库目录 /Users/user/Project/project-name
  • ❌ 不要打开 /Users/user/.cursor/worktrees/...

等待 30–120 秒让 Cursor 重新索引。

📊 效果对比

🟢 清理后效果

  • 磁盘占用下降 3–4 个数量级（千分之一到万分之一）
  • Cursor 秒回，完全不卡

✅ 总结

通过一次彻底清理，Cursor 可以满血复活。建议每 2-3 个月或修改项目名称后执行一次清理操作。

📖 原文链接

本文档内容整理自稀土掘金文章：

📌 Cursor 越用越慢？一次「索引污染」导致的极端卡顿排查与解决
作者：掘金online · 发布于：2025-12-23 · 阅读：3 分钟

← 返回文档中心