如何在不修改脚本行的情况下为CMake调用的Ninja传递选项？

问题场景 #

我正在用CMake和Ninja构建项目，现有脚本包含多条重复命令：

cmake dir1 && cmake --build . && ctest
cmake dir2 && cmake --build . && ctest
cmake dir3 && cmake --build . && ctest
...

只需在脚本顶部加export CMAKE_GENERATOR=Ninja就能切换到Ninja构建器，但想在不修改上述命令行的前提下，给Ninja传递自定义选项（比如示例中的-l 5），期望实现类似这种效果：

export CMAKE_GENERATOR=Ninja
export CMAKE_PASS_NINJA_OPTIONS="-l 5"   # 该选项实际不存在，仅作示例

cmake dir1 && cmake --build . && ctest
...

可行解决方案 #

1. 用CMAKE_BUILD_PARALLEL_LEVEL控制并行构建（最简单，适合资源限制） #

如果你的需求是控制并行任务数（比如示例的-l 5），CMake本身支持CMAKE_BUILD_PARALLEL_LEVEL环境变量，它会自动传递给Ninja作为-j（并行任务数）和-l（负载限制）参数：

export CMAKE_GENERATOR=Ninja
export CMAKE_BUILD_PARALLEL_LEVEL=5

直接在脚本顶部添加这两行即可，无需修改原有命令，CMake调用Ninja时会自动带上对应参数。

2. 自定义Ninja包装脚本（通用方案，支持任意参数） #

如果需要传递Ninja的其他参数（比如-v verbose输出、-k 0出错即停等），可以做一个Ninja的包装脚本，让CMake优先调用这个脚本：

• 第一步：创建包装脚本ninja_wrapper.sh，内容如下：

  #!/bin/bash
  # 替换成你系统中真实的Ninja路径，比如/usr/bin/ninja或者brew安装的/usr/local/bin/ninja
  REAL_NINJA="/usr/bin/ninja"
  # 这里写你要添加的自定义参数
  CUSTOM_NINJA_OPTS="-l 5 -v"
  # 把自定义参数和原命令的参数一起转发给真实Ninja
  exec "$REAL_NINJA" $CUSTOM_NINJA_OPTS "$@"
  

• 第二步：给脚本加执行权限：

  chmod +x ninja_wrapper.sh
  

• 第三步：在你的构建脚本顶部添加：

  export CMAKE_GENERATOR=Ninja
  # 把包装脚本所在目录放到PATH最前面，确保CMake先找到它
  export PATH="/存放wrapper的目录路径:$PATH"
  

这样CMake调用ninja时，实际会执行你的包装脚本，自动带上自定义参数。

3. 直接指定带参数的Ninja命令（不推荐） #

可以通过CMAKE_MAKE_PROGRAM环境变量，直接把带参数的Ninja命令传给CMake：

export CMAKE_GENERATOR=Ninja
export CMAKE_MAKE_PROGRAM="ninja -l 5"

注意：部分CMake版本对带参数的命令处理可能有兼容性问题，不如包装脚本稳定，仅作为备选方案。

内容的提问来源于stack exchange，提问作者alfC