Cursor 索引代码库（Codebase Indexing）卡住一直转圈？.cursorignore 配置方案

右下角 Codebase Indexing 进度条卡在 0% 或几十% 一动不动？深度排查 node_modules、dist、大体积日志与配置 .cursorignore 极速秒级索引实战。

为什么代码库索引会卡死？

Cursor 为了实现 @Codebase 的全局语义理解，会在后台将你的所有代码切片并计算向量嵌入（Embeddings）：
- 如果你的项目包含巨大的 node_modules/、build/、.next/ 或几百兆的日志与二进制数据文件，索引引擎会被数以万计的无关第三方文件彻底撑爆，导致队列假死。

配置 .cursorignore 一键秒级索引

在项目根目录下新建一个名为 .cursorignore 的文件，写入以下忽略清单：

保存后，打开 Cursor 设置 ➔ Features ➔ Codebase Indexing ➔ 点击 Resync Index（重新同步索引），进度条即可在几秒钟内飞速完成！

进入 Cursor Pro 比价专区 →