cmake

CMake 构建系统

补充说明

cmake 用 CMakeLists.txt 生成 Makefile/Ninja 等构建文件，支持跨平台和多配置构建。推荐源码外构建（out-of-source）。

常用示例

cmake -S . -B build
cmake -S . -B build -G Ninja
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/usr/local
cmake --build build -j 8
cmake --build build --target install
ctest --test-dir build --output-on-failure
cmake --install build
cmake --preset release

常用变量

易错点与排错

• 不要在源码目录内构建；缓存和产物会污染仓库。
• 改 CMakeLists.txt 后通常自动重新配置；缓存异常时删 build/CMakeCache.txt。
• find_package 失败先看 CMAKE_PREFIX_PATH 和依赖的 .cmake 文件。
• Debug/Release 的优化和断言不同；性能问题先确认构建类型。
• 交叉编译必须提供 toolchain file，不要只改编译器变量。
• compile_commands.json 对 clangd/clang-tidy 很有用，建议开启。
• 安装路径和 RPATH 会影响运行时找不到库。

相关命令

• ninja / make — 执行构建
• ctest — 测试
• pkg-config — 依赖查询