『CMake』关于使用CMake构建项目时的现代/传统指令

写在前面

最近才注意到使用CMake构建和编译项目时，使用的指令存在传统和现代两种写法，记录一下以备不时之需

概述

两种写法本质等价，差别仅在是否"生成器无关"、可移植性、脚本化友好，以及是不是只在类 Unix 上用 make

具体来说有以下的区别：

并行开关 ：现代 cmake --build ... --parallel 跨平台统一；传统 -j$(nproc) 只在类 Unix 顺手
配置选择 ：单配置（Make/Ninja）用 -DCMAKE_BUILD_TYPE=...；多配置（VS/Xcode）用 --config ...
可移植性：现代命令一套走天下；传统命令依赖具体构建器与 shell
工作流 ：现代天然 out-of-source，多构建目录好管理；传统常手动 cd build，容易写出"把中间文件丢源码树"的脚本
生态与可维护性 ：现代写法更容易接入 presets、打包、安装、工具链文件（-DCMAKE_TOOLCHAIN_FILE=...）等现代 CMake 习惯

最后，无论如何都更加推荐使用现代写法，除非是古早项目或者项目指定使用旧版本的cmake

现代写法

bash 复制代码

cmake -S <src> -B <build> [-DCMAKE_BUILD_TYPE=Release] [-DCMAKE_INSTALL_PREFIX=$PWD/install]
cmake --build <build> --parallel
cmake --install <build>   # 需要时

其中<src>是源码目录，<build>是构建和编译目录，通常是名为build的文件夹

特性

生成器无关 ：cmake --build 会自动调用对应的构建器（ninja/make/msbuild/xcodebuild），同一套命令跑遍 Linux/Windows/macOS
多配置友好 （VS/Xcode 这类多配置生成器）：配合 --config Release/Debug 使用，而不是 CMAKE_BUILD_TYPE
目录干净 ：天然 out-of-source（-S/-B），多个构建目录（Debug/Release/ASan...）并存不打架
脚本/CI 友好 ：选项清晰、可预测；再配合 CMakePresets.json 更香
一致并行参数 ：--parallel 统一了 -jN 的差异（Windows 上没有 nproc 这类工具）
更易移植：切换 Ninja、VS、Xcode、Make 都不用改命令

适用场景

跨平台维护（同一仓在 Linux + Windows + macOS 上编译）
需要多配置并存（Debug/Release/ASan/TSan）或不同工具链（gcc/clang/clang-cl）
CI/CD、容器、脚本化构建，或要用 CMakePresets.json 做一键配置
使用 Ninja、MSBuild、Xcode 等非 make 生成器
需要 cmake --install 做安装打包、CPack 出包

传统写法（类 Unix 风格）

bash 复制代码

mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

特性

绑定单一生成器 ：默认是 "Unix Makefiles"。换 Ninja/VS/Xcode 时命令要跟着改（如 ninja、msbuild）
单配置思维 ：CMAKE_BUILD_TYPE 只对单配置生成器（Makefiles/Ninja）直观。VS/Xcode 下常被忽略，需要改用 --config
shell 依赖 ：$(nproc)、管道、小工具在 Windows 上不可用或语法不同
上手快：在纯 Linux + make 的环境里，肌肉记忆强，输入最短

适用场景

只在 Linux/Unix 上、只用 make，团队已有大量历史脚本/文档
个人本机快速编译、对跨平台不敏感
CMake 版本老（非常老的发行版上没有 -S/-B / --install / --parallel）

其他环境的写法

Linux + Ninja（推荐构建器，速度快）

bash 复制代码

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel

Linux + Make（传统）

bash 复制代码

mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j"$(nproc)"

Windows + Visual Studio（多配置）

bash 复制代码

cmake -S . -B build -G "Visual Studio 17 2022"
cmake --build build --config Release --parallel

macOS + Xcode（多配置）

bash 复制代码

cmake -S . -B build -G Xcode
cmake --build build --config Release --parallel