Cursor Codebase 索引机制详解：如何建立语义搜索让 AI 彻底读懂你的大型项目

为什么 Cursor 能精准找到你在另一个文件里定义的类型？深入剖析 Codebase Indexing 本地嵌入索引原理，教你优化 .cursorignore 排除无关文件提升回答精度。

为什么传统的关键字搜索在大型项目中失效？

传统编辑器只支持文件名或正则文本检索，无法理解“这个函数是负责处理用户鉴权的”这种抽象意图。Cursor 在后台为你的代码库生成了高维语义嵌入向量（Embeddings），当你用自然语言提问时，它能通过语义相似度瞬间定位相关的核心文件。

优化索引的三大实战操作

1. 及时检查 Indexing 状态：在 Settings -> Features -> Codebase Indexing 中，确保状态显示为 100% Indexed；
2. 配置 .cursorignore 文件：将 node_modules、dist、build、.git 等无意义的打包产物彻底排除，防止无效数据污染向量库；
3. 在提问时主动使用 @Codebase 引导模型进行全局语义穿透。