CMakeLists.txt是C++项目构建核心，定义结构、源码、依赖与编译选项。2. 基础配置含最低版本、项目名与可执行文件。3. 多源文件用set()组织。4. 指定C++标准如17版。5. 头文件目录通过target_include_directories添加。6. 静态或共享库用add_library创建并链接。7. 子目录项目用add_subdirectory管理。8. 编译选项按编译器设置警告。9. 构建在build目录执行cmake与make，保持源码整洁。清晰配置提升可维护性与跨平台能力。
在C++项目中，CMakeLists.txt 是 CMake 构建系统的核心配置文件，用于定义项目的结构、源文件、依赖关系和编译选项。下面是一个实用的编写指南，帮助你快速上手创建 CMake 项目。
1. 最基本的 CMakeLists.txt 示例
适用于一个简单的可执行程序项目：
cmake_minimum_required(VERSION 3.10)
project(MyApp)
立即学习“C++免费学习笔记（深入）”；
add_executable(myapp main.cpp)
说明：
- cmake_minimum_required：指定所需最低 CMake 版本，避免使用过新特性导致兼容问题。
- project：定义项目名称，可选设置语言（如 CXX）和版本。
- add_executable：将源文件编译为可执行文件，myapp 是生成的可执行名，main.cpp 是源码文件。
2. 添加多个源文件
如果项目包含多个 .cpp 文件：
set(SOURCES
main.cpp
utils.cpp
math.cpp
)
add_executable(myapp ${SOURCES})
使用 set() 定义变量来组织源文件列表，提高可读性。
3. 指定 C++ 标准
现代 C++ 通常需要 C++17 或更高版本：
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
这会强制编译器使用 C++17，并报错不支持的情况。
4. 包含头文件目录
如果头文件放在 include/ 目录下：
target_include_directories(myapp PRIVATE include)
PRIVATE 表示该路径仅用于当前目标。也可以用 PUBLIC 或 INTERFACE，用于库项目传递包含路径。
5. 编译静态或共享库
创建静态库：
add_library(mylib STATIC utils.cpp math.cpp)
创建共享库（动态库）：
add_library(mylib SHARED utils.cpp math.cpp)
然后让可执行文件链接这个库：
target_link_libraries(myapp mylib)
6. 处理子目录项目
大型项目常把代码分到不同目录，例如 src/ 和 lib/。
根目录 CMakeLists.txt：
cmake_minimum_required(VERSION 3.10)
project(MyProject)
add_subdirectory(lib)
add_subdirectory(src)
在 src/CMakeLists.txt 中：
add_executable(app main.cpp)
target_link_libraries(app mylib)
在 lib/CMakeLists.txt 中：
add_library(mylib STATIC utils.cpp)
target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
7. 设置编译选项和警告
增强代码质量，开启常用警告：
if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR
CMAKE_CXX_COMPILER_ID MATCHES "Clang")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -Wpedantic")
endif()
可根据编译器类型添加不同的标志。
8. 生成构建文件并编译
在项目根目录执行：
mkdir build
cd build
cmake ..
make
这样会在 build 目录生成 Makefile 并编译项目，避免污染源码目录。
基本上就这些。一个清晰的 CMakeLists.txt 能大幅提升项目可维护性和跨平台能力。从简单开始，逐步添加功能，就能轻松管理复杂 C++ 工程。
