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

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

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

<div class="search-intent-box">
<span class="kicker">QUICK TAKE · 核心速览</span>
<h3>💡 核心结论与立即排查建议</h3>
<ul>
<li><b>核心定性：</b>右下角 Codebase Indexing 进度条卡在 0% 或几十% 一动不动？深度排查 node_modules、dist、大体积日志与配置 .cursorignore 极速秒级索引实战。</li>
<li><b>适用场景：</b>针对日常深入使用、代码重构、输出排版与模型调度中的具体痛点，提供 100% 实测可复现的工程级解决方案。</li>
<li><b>安全防范：</b>排障与配置过程中切勿盲目重复尝试高风险操作，涉及系统配置文件时建议先做本地备份。</li>
</ul>
</div>

---

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

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

配置 .cursorignore 一键秒级索引

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

```text
node_modules/
.git/
.next/
dist/
build/
out/
*.log
*.lock
package-lock.json
yarn.lock
pnpm-lock.yaml
coverage/
.cache/
*.sqlite
*.sqlite3
*.tar
*.zip
```
保存后，打开 Cursor 设置 ➔ **Features** ➔ **Codebase Indexing** ➔ 点击 **Resync Index（重新同步索引）**，进度条即可在几秒钟内飞速完成！

---

<div class="product-cta-card">
<div class="product-cta-content">
<span class="tag">Cursor Pro 实时行情与渠道</span>
<h3>👉 查看 Cursor Pro 实时渠道报价与健康度监控</h3>
<p>避开各类网络与支付报错，全网严选低风险直充与一手账号，省时省力快速开通。</p>
</div>
<a class="btn" href="/?family=cursor&product=cursor-pro">进入 Cursor Pro 比价专区 →</a>
</div>