Ninja 默认满载使用所有CPU核心，但CMake生成的隐式串行约束（如pool限制、order-only依赖）会导致实际并发不足；应优化构建图结构、避免假依赖、合理使用pool和链接器并行选项。
Ninja 本身不决定并发数，它默认就满载使用所有可用 CPU 核心，但你得让 CMake 生成的 build.ninja 文件不含隐式串行约束，否则再多核也跑不满。
为什么 ninja -jN 不总生效
Ninja 默认行为是自动检测逻辑核心数并设为并发上限（通常是 sysconf(_SC_NPROCESSORS_ONLN) × 2），所以多数情况下直接运行 ninja 就已并行拉满。但实际中常出现“明明有 16 核，ninja 只跑 2–3 个编译进程”的情况，根本原因不是 Ninja 限制了并发，而是：
- CMake 生成的规则里加了
pool限制（比如link_pool或自定义consolepool），而链接阶段天然串行，若大量目标被错误归入同一 pool，会拖慢整体进度 - 项目中存在显式
order-only dependencies（如| build_timestamp.h），导致 Ninja 主动插入等待点 - 某些 CMake 的
add_custom_target或add_custom_command没设USES_TERMINAL或COMMAND_EXPAND_LISTS，触发隐式串行执行
验证方式：运行 ninja -d explain，观察输出中是否频繁出现 waiting for a slot in pool 或 waiting for order-only dep。
如何让 CMake 生成真正适合并发的 Ninja 文件
CMake 本身不控制 Ninja 的并发调度逻辑，但它生成的构建图结构直接影响 Ninja 能否并行。关键在避免“假依赖”和“过度同步”：
- 禁用 CMake 的全局
set(CMAKE_DEPENDS_USE_COMPILER OFF)—— 这会让 Ninja 无法利用编译器自动生成的头文件依赖，被迫退化为全量重编或误判依赖 - 慎用
file(GENERATE ...)或configure_file(... @ONLY)在add_library之前——这类命令默认产生 order-only 依赖，会卡住后续所有编译任务 - 对生成代码的目标（如 protobuf、flatbuffers），用
add_custom_command(OUTPUT ... BYPRODUCTS ...)显式声明产出物，而非靠DEPENDS拉整个目录 - 如果项目含大量小目标（如每个
.cpp对应一个add_executable），考虑合并为单个add_library(... OBJECT)，减少 Ninja 图节点数（节点过多会增加调度开销）
实测有效的并发调优参数组合
单纯改 -j 值效果有限，真正起作用的是配合 Ninja 的 pool 机制和 CMake 的构建策略：
- 编译阶段压满：默认即可，无需干预；若想限制避免内存溢出，用
ninja -j$(nproc --all)（Linux）或ninja -j$(sysctl -n hw.ncpu)（macOS） - 链接阶段提速：在 CMakeLists.txt 中启用 LTO 和并行链接器，例如
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -flto=auto -Wl,--threads")（GCC/Clang） - 规避 I/O 瓶颈：把
CMAKE_BINARY_DIR放在 SSD 上，且避免与源码同盘；Ninja 对磁盘延迟敏感，尤其在读取成千上万个.d依赖文件时 - 禁用 Ninja 的 restat 开销：若项目不依赖
restat（即不靠输出时间戳反推输入变更），可在 CMake 配置时加-DCMAKE_NINJA_ALWAYS_RESOLVE_DEPS=OFF（CMake 3.22+），跳过每次构建前的 stat 扫描
容易被忽略的“并发失效”信号
不是所有慢都源于并发不足。以下现象说明问题不在 -j 参数，而在于构建图设计或工具链配置：
-
ninja -t graph | dot -Tpng > graph.png生成的依赖图中，出现大量长链（chain depth > 50），说明模块耦合过重，Ninja 不得不串行处理 - 运行
ninja -d stats后发现edges run远小于total edges，表示大量目标因依赖未就绪被挂起，而非资源不足 - top 或 htop 中
ninja进程 CPU 占用长期低于 200%，但磁盘 I/O 持续 100% —— 这是依赖文件扫描或 ccache 查找瓶颈，不是并发问题
真正的并发效率，取决于 CMake 如何描述依赖、Ninja 如何解析那张图，以及你的源码组织是否允许它被拆解。别只盯着 -j，先看 ninja -d explain 输出里那一句句 “waiting for”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
