incredibuild 编译失败“build failed: no agents available”表明未连接代理节点，需检查windows服务状态、防火墙端口40001/40002放行及linux/wsl仅支持手动注册remote agent；vs中编译变慢主因配置未对齐，须启用use incredibuild和multi-processor compilation，禁用/gm；cmake项目需通过vs生成器或buildconsole调用；链接失败因obj未同步，需开启copy intermediate files；其仅加速标准msvc流程，不支持自定义脚本或非msvc工具链。
incredibuild 编译失败提示 Build failed: No agents available
这是最常见启动即失败的信号，说明 Incredibuild 没连上任何代理节点（agent），不是代码问题，是环境没通。
排查重点在权限、服务状态和网络策略：
• Windows 上确认 Incredibuild Agent 服务已启动（非“已禁用”，也非“手动”但没运行）
• 防火墙默认会拦掉 IBServer.exe 和 IBAgent.exe 的入站连接，需放行 TCP 端口 40001（主控端）和 40002（代理端）
• 如果 agent 装在 WSL 或远程 Linux 机器上：Incredibuild 官方只支持 Windows agent；Linux/macOS 仅能作为「辅助构建机」通过 IBConsole 手动注册为「Remote Agent」，且需额外安装 ibremoteagent，不参与 C++ 原生编译任务分配
• Visual Studio 插件里点 Build → Build with IncrediBuild 前，先打开 IBConsole 看右下角是否显示绿色 “Connected to Coordinator”
VS 中启用 IncrediBuild 后编译速度反而变慢
根本原因通常是项目配置没对齐，让 IncrediBuild 退化成单机串行执行，甚至加了 IPC 开销。
关键检查点：
• 确认项目属性里 Configuration Properties → General → Use IncrediBuild 设为 Yes（不是靠全局开关）
• 检查 Configuration Properties → C/C++ → General → Multi-processor Compilation 必须设为 Yes，否则 MSVC 不生成多线程编译任务，Incredibuild 拿不到可分发单元
• 避免混用 /MP 和 /Gm-：若启用了最小重建（/Gm），Incredibuild 会自动禁用分布式编译，因为依赖图太细、同步成本高
• 头文件变动频繁时，Incredibuild 的缓存命中率低，首次全量编译快，但后续小改可能比本地 /MP 还慢——这不是 bug，是设计取舍
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
如何让 CMake 项目走 IncrediBuild
CMake 本身不识别 IncrediBuild，必须通过生成器或工具链桥接。
两种可靠路径：
• 用 Visual Studio 生成器：运行 cmake -G "Visual Studio 17 2022" -A x64 -T host=x64 ..，再用 VS 打开 sln 并按前述方式启用 IncrediBuild
• 命令行直调：CMake 生成后，不用 cmake --build，改用 devenv /build Debug YourSolution.sln /out build.log，再配合 IncrediBuild 的 BuildConsole 工具：BuildConsole YourSolution.sln /cfg="Debug|x64" /rebuild /useenv
• 注意：CMakeLists.txt 里写死的 add_compile_options(/MP) 无效，Incredibuild 控制并行粒度，不依赖编译器开关
链接阶段卡住或报 LINK : fatal error LNK1181: cannot open input file
这是分布式编译典型副作用：obj 文件由不同 agent 编译，但链接器（link.exe）默认只在 coordinator 本地找 obj，而 agent 生成的 obj 默认存在其本地临时目录，不会自动同步回来。
必须显式开启中间产物同步：
• 在 VS 项目属性中打开 Configuration Properties → General → Use IncrediBuild → Advanced → Copy intermediate files to coordinator
• 或在 BuildConsole 命令加参数 /copyintermediates
• 如果项目含自定义生成步骤（如 .idl/.rc 处理），确保这些步骤的输出路径被 BuildConsole 正确识别，否则链接时找不到对应 .obj —— 此时需在 Custom Build Tool 属性页勾选 Use IncrediBuild for this tool
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
