CodeBuddy C++大型工程问题源于工具链配置、上下文窗口限制或索引未加载，需依次配置编译器路径、重建全项目索引、调大跨文件上下文行数、启用模板分析、使用CLI高精度重构，并导出AST验证解析完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行 C++ 开发时，发现大型工程中代码补全不准确、跨文件重构失败或上下文感知迟钝，则可能是由于工具链配置、模型上下文窗口限制或项目索引未完整加载所致。以下是解决此问题的步骤：
一、确认 C++ 环境与编译器集成状态
CodeBuddy 本身不内置 C++ 编译器，其对 C++ 的支持依赖于外部工具链（如 MinGW-w64 或 TDM-GCC）及 IDE 层面对语言服务器协议（LSP）的支持。正确配置后，CodeBuddy 才能解析 AST 并实现跨作用域补全与重构。
1、打开 CodeBuddy 设置界面，进入 Settings > Build Tools > C++ Compiler Path。
2、输入已安装的 g++.exe 完整路径（例如：C:\mingw64\bin\g++.exe），确保该路径下同时存在 gcc.exe 和 gdb.exe。
立即学习“C++免费学习笔记（深入）”；
3、在项目根目录下检查是否存在 compile_commands.json 或 CMakeLists.txt；若存在，需在设置中启用 CMake Language Server 支持。
二、启用工程级索引与上下文缓存
大型 C++ 工程（含数百个头文件与源文件）需要 CodeBuddy 主动构建符号索引。默认情况下，仅当前打开文件被深度分析；启用全工程索引后，补全与重构才能覆盖 include 链、模板特化及跨模块调用关系。
1、在 CodeBuddy IDE 或插件中，点击左下角状态栏的 “Indexing” 图标，选择 “Rebuild Full Project Index”。
2、等待右上角提示 “Indexing completed for N files”（N 应接近工程实际源文件总数）。
3、手动触发一次 “Refresh AST Cache”（可在命令面板中输入该指令并执行）。
三、调整补全与重构行为参数
CodeBuddy 默认采用平衡响应速度与准确率的策略，在大型工程中可能主动降级跨文件补全强度。通过显式提升上下文窗口权重与启用深度语义推理，可显著改善复杂场景下的表现。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
1、进入 Settings > AI Engine > Context Window，将 “Max Cross-File Context Lines” 调整为 500。
2、开启 “Enable Template Instantiation Analysis” 选项，以支持 STL 容器、智能指针等模板类型推导。
3、在重构操作前，选中目标函数或类名，右键选择 “Refactor with Full Semantic Context”（而非普通重命名）。
四、切换至 CLI 模式执行高精度重构
当 IDE 插件在图形界面中因内存限制无法完成大范围重构时，CodeBuddy CLI 提供基于进程隔离的离线分析能力，支持对整个 src/ 目录执行符号级重命名、接口提取与依赖图生成，且不依赖 IDE 实时渲染性能。
1、确保已安装 @tencent-ai/codebuddy-code（Node.js 18.0+ 环境下运行 npm install -g @tencent-ai/codebuddy-code）。
2、在项目根目录执行：codebuddy refactor --target src/ --rename "OldClass" --to "NewClass" --deep。
3、查看生成的 refactor-report.json，确认所有匹配位置（含头文件声明、模板实例化点、宏展开结果）均被识别。
五、验证 AST 解析完整性
补全与重构失效的根本原因常在于 AST 构建中断——例如预处理器宏未展开、系统头文件路径缺失或 C++ 标准版本不匹配。通过强制触发 AST 导出，可定位具体解析断点。
1、在任意 .cpp 文件中，将光标置于疑似未识别的类成员函数定义行。
2、调出命令面板（Ctrl+Shift+P），输入并执行：“CodeBuddy: Export Current AST to JSON”。
3、检查输出文件中是否存在 "classDecl" 节点及其 "bases" 字段；若 "bases" 为空或报错 “unresolved base class”，说明头文件包含路径未被正确注入。
