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：
project(MyApp)
add_executable(myapp main.cpp)
然后终端里执行三步：
立即学习“C++免费学习笔记（深入）”；
-
建构建目录（别在源码目录里直接 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 头文件在哪、哪些源码参与编译：
project(MyApp)
# 声明可执行目标
add_executable(myapp
src/main.cpp
src/utils.cpp
)
# 让 myapp 能 #include "utils.h"
target_include_directories(myapp PRIVATE include)
注意用 target_include_directories（推荐）而不是老式的 include_directories，因为它是“绑定到具体目标”的，更清晰、更安全。PRIVATE 表示头路径只对 myapp 本身有效，不传递给依赖它的其他目标。
链接第三方库：find_package + target_link_libraries
比如你想用 Boost.Filesystem：
# 在 project() 后面加上find_package(Boost REQUIRED COMPONENTS filesystem system)
# 在 add_executable 之后
target_link_libraries(myapp PRIVATE Boost::filesystem Boost::system)
关键点：
-
find_package会搜索系统或指定路径下的库，成功后定义Boost::filesystem这样的“导入目标” -
target_link_libraries把库连到你的可执行文件，PRIVATE 表示不暴露给使用者 - 如果库不在标准路径（如自己编译的 OpenCV），加
-DOpenCV_DIR=/path/to/opencv/share/opencv给 cmake 命令
常用变量和调试技巧
写错 CMakeLists.txt？加几行打印帮助定位：
# 打印当前源码路径message(STATUS "Source dir: ${CMAKE_SOURCE_DIR}")
# 检查某个变量是否存在
if(NOT Boost_FOUND)
message(FATAL_ERROR "Boost not found!")
endif()
几个高频变量：
-
${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。
