更新时间：2026-09-10 GMT+08:00

代码库索引

你可以为项目构建索引，来提升AI在代码库中的检索速度与准确度，使结果更贴合你的需求。还可以通过配置忽略文件，来指定在构建代码索引时需剔除的文件。被忽略的文件将完全被排除在代码索引之外，从而有效保护你的敏感数据。

代码库索引提供了如下两种模式，请结合你的使用场景，自由选择合适的索引构建方式。

本地索引：通过本地索引构建图谱索引，解析本地项目代码文件，精准检索函数、类、文件之间的调用、依赖与继承关系。
云端索引：借助代码库索引构建向量索引，基于代码语义，实现功能维度的智能检索与精准匹配。如果你使用的是企业版（新版套餐）或原个人版/体验版/基础版/专业版（旧版套餐），请确保账号已启用席位，若席位未启用，会导致云端索引创建失败。

表1 本地索引和云端索引功能对比
对比维度	本地索引	云端索引
存储位置	索引文件存储在你的本地设备（当前项目根目录的“.codegraph”路径下）	首次构建索引，完整索引包上传存储至云端；代码变更生成的增量索引，保存在本地设备（当前项目根目录的“.codeartsdoer/.codebase”路径下）
搜索能力	支持关键词、符号、文件名检索	语义理解，全库代码逻辑分析
构建规则	文件数<50000的项目：打开项目时自动构建索引文件数≥50000的项目：首次构建需手动触发
更新规则	文件发生变更自动更新	开启自动更新且代码库文件数量小于50000时自动更新，其余场景需手动操作

表2 约束与限制
限制类别	具体限制
语言	支持Java、JavaScript、TypeScript、Go、ArkTS、C、C++、Python、Vue和Lua。
索引代码文件总数	旧版套餐体验版≤5千个基础版≤5万个专业版≤10万个新版套餐个人体验版≤5千个个人标准版/高级版/旗舰版≤5万个企业专业版≤20万个
功能限制	仅企业版（新版套餐）或基础版、专业版（旧版套餐）支持创建云端团队级和企业级代码库索引。本地索引仅支持在Windows、Linux系统下创建。

参考快速启动操作，登录码道IDE。
单击页面右上角的设置图标，进入IDE模式全局设置页面。
选择“代码库索引”，查看代码库索引构建结果。

如果看到图1页面，说明你的项目代码文件不足50000个，代码库索引已构建完成。没有看到该页面，可以根据你的具体使用场景，选择构建本地索引或云端索引。
图1 索引构建成功

输入你要查找的内容，查看代码检索效果。

探索代码库中所有调用is_input_required的位置，包括跨文件调用关系

图2 查看检索结果

代码库索引除了创建外，还支持重启、删除等操作，具体参见表3。

表3 管理代码库索引
操作	操作指导
暂停云端索引	在云端索引构建过程中，如果您想停止构建，可以单击“暂停”。
重启云端索引	如果需要恢复已暂停的索引构建，可单击“继续索引”继续执行。
同步云端更新	单击“同步更新”，执行增量索引更新，即系统会对比当前状态与上一次增量更新的结果，仅对新增或修改过的代码文件进行索引，跳过未变更文件以节省时间。
重新云端索引	索引删除后，如果需要从头开始重建索引，可单击“开始索引”触发完整索引流程。
删除云端索引	如果需要清除当前所有索引数据，可单击“删除索引”进行清理。除了在客户端删除代码库索引，你还可以到控制台执行删除操作，详细介绍请参见删除云端代码库索引。
忽略当前目录中的文件	如果您期望忽略指定代码文件的索引，可以单击“配置”，在“.codebaseignore”中指定当前目录下希望忽略的代码文件。

父主题：上下文