Copilot CLI 借助全代码库索引实现更快的 C++ 代码智能
内容提要
GitHub Copilot CLI 的 C++ 代码智能现已支持全代码库索引（WCI），由微软 C++ 语言服务器驱动，基于 compile_commands.json 建立持久符号索引，无需打开 IDE 即可理解整个项目。该功能可加快定义、引用、实现和符号搜索，减少重复解析，更好支持大型仓库与并行代理工作流。索引默认启用，首次构建可能耗时并暂时增加内存，之后可复用并动态更新。
延伸解读
索引机制与依赖条件
全代码库索引（WCI）由微软 C++ 语言服务器驱动，依赖项目有效的 compile_commands.json 文件来获取编译上下文。该文件描述源文件的编译方式，是建立准确符号索引的基础。语言服务器为 CMake 和 MSBuild 项目提供内置配置技能，也支持为自定义构建生成配置技能。索引在 CLI 内运行，无需打开 IDE 即可建立和维护项目理解。
首次索引的成本与后续收益
首次打开带有有效 compile_commands.json 的 C++ 项目时，语言服务器会开始加载或构建整个项目的符号索引。初始索引时间取决于仓库大小、复杂度及可用编译信息，并可能暂时增加内存消耗。索引完成后可被后续代码智能请求复用并动态更新，因此额外开销主要集中于初始设置阶段。
对大型仓库与并行代理的价值
持久索引减少了反复探索相互关联源码树的成本，使定义、引用、实现和工作区符号搜索减少重复分析。对于并行代理工作流，多个代理可复用同一已索引工作区的仓库理解，而不必各自重新发现和解析相同代码。这为个人和并行 Copilot 工作流带来更快、更可扩展的代码探索体验。
监控与临时禁用选项
用户可通过 Copilot CLI 的 /lsp logs 命令随时检查语言服务器和索引进度。如果观察到与索引相关的持续性能或资源问题，可依据索引文档临时禁用 WCI。禁用后代码智能功能仍可用，但语言服务器将无法受益于持久化的全代码库索引。
Q&A
Copilot CLI 的 C++ 代码智能新增了什么功能？
新增了对全代码库索引（WCI）的支持，由微软 C++ 语言服务器驱动，可维护整个项目的持久符号索引。
全代码库索引（WCI）是如何工作的？
WCI 依赖有效的 compile_commands.json 文件，语言服务器据此加载或构建整个项目的符号索引，索引可复用并动态更新。
使用 WCI 需要什么前提条件？
需要安装并配置微软 C++ 语言服务器，并且项目需有有效的 compile_commands.json 文件。
WCI 对大型 C++ 仓库有什么好处？
持久索引减少了重复探索互连源代码树的成本，使定义、引用、实现和符号搜索更快，并支持并行代理工作流。
首次使用 WCI 时需要注意什么？
首次构建索引可能耗时较长，并暂时增加内存消耗，具体取决于仓库大小和复杂度。
如何查看索引进度或禁用 WCI？
可以在 Copilot CLI 中使用 /lsp logs 查看语言服务器和索引进度；若遇到持续性能问题，可参考索引文档暂时禁用 WCI。
