CMake构建C++项目核心三步：写CMakeLists.txt、源外构建配置、生成编译；最小示例含cmake_minimum_required、project、set标准、add_executable；推荐FetchContent管理依赖，调试用-Wdev和message。
用 CMake 构建 C++ 项目，核心就三步：写 CMakeLists.txt、配置构建目录、生成并编译。不依赖 IDE，跨平台一致，适合从命令行到 CI 的所有场景。
写好最简 CMakeLists.txt
这是项目的“构建说明书”，放在项目根目录。一个能编译单个源文件的最小示例：
cmake_minimum_required(VERSION 3.10) project(MyApp) set(CMAKE_CXX_STANDARD 17) add_executable(MyApp main.cpp)
说明：
– cmake_minimum_required 声明最低 CMake 版本（推荐 3.10+）；
– project() 定义项目名和默认语言标准；
– set(CMAKE_CXX_STANDARD 17) 显式启用 C++17；
– add_executable() 指定可执行文件名和源码，支持多个 .cpp 文件，如 add_executable(MyApp main.cpp utils.cpp)。
在终端里完成配置与构建
别在源码目录里直接运行 cmake —— 这叫“源内构建”，容易污染项目。推荐“源外构建”：
- 新建独立构建目录：
mkdir build && cd build - 配置项目（生成 Makefile / Ninja / VS 解决方案等）：
cmake .. - 编译：
cmake --build .（自动适配后端，比make或ninja更统一）
想换编译器？加参数：cmake -DCMAKE_CXX_COMPILER=g++-12 ..；想用 Ninja 而不是 Make？cmake -G Ninja ..。
立即学习“C++免费学习笔记（深入）”；
管理依赖和第三方库
现代 C++ 项目常需 Boost、fmt、spdlog 等。推荐用 find_package + target_link_libraries：
find_package(fmt REQUIRED) add_executable(MyApp main.cpp) target_link_libraries(MyApp PRIVATE fmt::fmt)
如果库没装系统级路径，可通过 -Dfmt_DIR=/path/to/fmt/lib/cmake/fmt 指定位置。
更轻量的替代方案是 FetchContent（CMake 3.14+），自动下载编译，适合 header-only 或小型依赖：
include(FetchContent) FetchContent_Declare( spdlog GIT_REPOSITORY https://github.com/gabime/spdlog.git GIT_TAG v1.14.1 ) FetchContent_MakeAvailable(spdlog) target_link_libraries(MyApp PRIVATE spdlog::spdlog)
调试与常见报错提示
CMake 报错大多出在路径、版本或找不到包。快速排查建议：
- 加
-Wdev查看开发警告：cmake -Wdev .. - 用
message(STATUS "xxx")在 CMakeLists.txt 中打印变量值 - 检查
find_package是否成功：它会设置_FOUND if(NOT fmt_FOUND) message(FATAL_ERROR "fmt not found") - 忘记
target_include_directories？头文件找不到时，记得显式导出包含路径，尤其是自定义库
基本上就这些。CMake 看似语法多，但日常 80% 场景靠上面几条就能跑通。不复杂但容易忽略细节 —— 写对 CMakeLists.txt 结构，再配好构建流程，项目就稳了。
