cmake 常用命令（6条）

1️⃣ 生成构建目录（配置工程）

cmake -S.-B build

解析：

• -S .：源码目录（Source），.表示当前目录（可以省略）
• -B build：构建目录（Build），build/是放生成文件的目录

作用：读取CMakeLists.txt，生成“工程构建文件”（Makefile / Ninja 等），但不编译代码。

执行后发生的事：

1. CMake 会检查你的系统：
   • 哪个编译器可用（gcc/g++/clang）
   • 哪些库可用（Boost、OpenSSL 等）
2. 生成缓存文件：
   • CMakeCache.txt→ 保存变量
   • Makefile或build.ninja
3. 所有中间产物都在build/，源码目录保持干净

举例

project/ ├── CMakeLists.txt ├── src/ └── build/ ← 生成后 ├── Makefile └── CMakeCache.txt

2️⃣ 带选项配置工程

cmake -S.-B build -DENABLE_LOG=ON -DCMAKE_BUILD_TYPE=Release

解析：

• -DENABLE_LOG=ON→ 给工程传选项

  • 例如 CMakeLists.txt 里可能有：

    option(ENABLE_LOG "Enable logging" OFF)

  • 开启后会在编译时定义宏ENABLE_LOG，对应代码里#ifdef ENABLE_LOG会生效

• -DCMAKE_BUILD_TYPE=Release→ 指定构建类型

  • Release：优化编译（速度快、体积小）
  • Debug：带调试信息（便于断点调试）

注意

• 配置选项可以有很多，例如：
  • ON/OFF
  • 路径：-DLIBRARY_PATH=/usr/local/lib
• 配置只是修改CMakeCache.txt，还是不编译

3️⃣ 编译工程

cmake --build build

等价于：

cdbuildmake

解析：

• 实际调用编译器（g++ / gcc / clang）
• 将源码.cpp→ 中间文件.o→ 最终可执行文件或库.so/.a
• 默认使用配置阶段生成的 Makefile 或 Ninja

举例：

build/ ├── bin/hello ← 可执行文件 └── lib/libxxx.so ← 库文件

4️⃣ 多核编译（加速）

cmake --build build -j8

解析：

• -j 8→ 同时使用 8 个 CPU 核心并行编译

• 相当于：

  make-j8

• 大型工程用多核能明显加快编译速度

5️⃣ 安装工程

cmake --install build

等价于：

cdbuildmakeinstall

解析：

• 将可执行文件、库、头文件等，拷贝到系统指定目录（默认/usr/local）

• 文件会按照 CMakeLists.txt 中的install()指令分类：

  install(TARGETS myapp DESTINATION bin) install(FILES mylib.h DESTINATION include)

• 作用：

  • 系统全局可用
  • 其他程序可以引用

6️⃣ 指定安装路径

cmake -S.-B build -DCMAKE_INSTALL_PREFIX=/opt/myapp

解析：

• CMAKE_INSTALL_PREFIX→ 自定义安装路径
• 例如上例中，安装后文件会在：

/opt/myapp/bin/myapp /opt/myapp/include/mylib.h /opt/myapp/lib/libxxx.so

用处：

• 避免覆盖/usr/local系统文件
• 可以在自定义目录打包或分发

七、核心记忆点