CMake构建C++项目需明确源码位置、依赖库、编译方式和生成目标；从单文件开始，用cmake_minimum_required、project、add_executable定义基础结构，通过target_include_directories指定头文件路径，find_package与target_link_libraries链接第三方库，并利用message和内置变量调试常见路径与命名错误。

刚接触 C++ 项目构建，CMake 是绕不开的一关。它不难，但容易卡在 CMakeLists.txt 写不对、找不到头文件、链接失败这些细节上。核心就一点：把“源码在哪、依赖什么、怎么编译、生成什么”这四件事说清楚，CMake 就能帮你自动搞定。

从最简项目开始：一个可执行文件

新建一个文件夹，放一个 main.cpp：

在同一目录下创建 CMakeLists.txt：

然后终端里执行三步：

• 建构建目录（别在源码目录里直接 cmake）：mkdir build && cd build
• 配置：cmake ..（会生成 Makefile 或 VS 工程等）
• 编译：cmake --build .（或 make）

运行 ./myapp 就成了。记住：每次改了 CMakeLists.txt，只需重新运行 cmake ..，不用删 build 目录（除非你换编译器或路径）。

加源文件和头文件：include_directories 和 target_include_directories

如果项目有 src/main.cpp、include/utils.h、src/utils.cpp，结构更真实了。这时要告诉 CMake 头文件在哪、哪些源码参与编译：

注意用 target_include_directories（推荐）而不是老式的 include_directories，因为它是“绑定到具体目标”的，更清晰、更安全。PRIVATE 表示头路径只对 myapp 本身有效，不传递给依赖它的其他目标。

链接第三方库：find_package + target_link_libraries

比如你想用 Boost.Filesystem：

关键点：

• find_package 会搜索系统或指定路径下的库，成功后定义 Boost::filesystem 这样的“导入目标”
• target_link_libraries 把库连到你的可执行文件，PRIVATE 表示不暴露给使用者
• 如果库不在标准路径（如自己编译的 OpenCV），加 -DOpenCV_DIR=/path/to/opencv/share/opencv 给 cmake 命令

常用变量和调试技巧

写错 CMakeLists.txt？加几行打印帮助定位：

几个高频变量：

• ${CMAKE_SOURCE_DIR}：最外层 CMakeLists.txt 所在目录
• ${CMAKE_BINARY_DIR}：你运行 cmake 的那个 build 目录
• ${CMAKE_CURRENT_LIST_DIR}：当前 CMakeLists.txt 所在目录（子项目常用）

报错常见原因：路径写错（多一个 ../ 或少一个 /）、库名大小写不对（Boost::filesystem 不是 boost_filesystem）、没加 find_package 就直接 target_link_libraries。