target_sources()是现代cmake（3.13+）添加源文件最推荐方式，支持动态注入子目录源码、生成文件及条件编译，配合private/public/interface精准控制作用域，避免file(glob)的不可靠性。
target_sources() 是当前 CMake 项目中添加源文件最推荐、最可控的方式，尤其在现代 CMake（3.13+）实践中。它比 add_executable() 或 add_library() 里硬塞文件列表更灵活，也比 file(GLOB) 更可靠。
什么时候必须用 target_sources()
当你需要在目标创建后动态添加源文件时，target_sources() 不是可选项，而是唯一合理选择：
- 子目录的
CMakeLists.txt要向父目录定义的目标（如myapp）注入自己目录下的utils.cpp—— 不能在父目录的add_executable()里预写死路径 - 通过
add_custom_command()生成的源文件（比如proto_gen.cpp），构建时才存在，初始add_executable()调用根本看不到它 - 按编译配置有条件地添加文件：例如
if(WIN32) target_sources(app PRIVATE win_impl.cpp) endif()，逻辑清晰且作用域明确 - 想把头文件也纳入 IDE（如 VS）的“Header Files”分组显示，只需加进
target_sources()（哪怕只是INTERFACE或PUBLIC）
PRIVATE / PUBLIC / INTERFACE 怎么选
这三个关键字决定源文件是否参与依赖传递，不是“要不要编译”，而是“编译谁、影响谁”：
-
PRIVATE：最常用。只用于编译目标自身，不暴露给依赖者。实现类（.cpp）一律用这个 -
PUBLIC：既编译目标自身，又让依赖该目标的其他目标也能“看到”这些文件（主要是头文件）。例如你建一个库mylib，并希望使用者能#include "mylib.h"，就把mylib.h用PUBLIC加入target_sources(mylib PUBLIC mylib.h) -
INTERFACE：目标自身不编译这些文件，但依赖它的目标会收到。纯头文件库（header-only）可用，但对.cpp文件基本无意义，别乱用
错误示例：target_sources(app INTERFACE impl.cpp) —— 这会导致 impl.cpp 完全不编译，链接失败。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
为什么不要依赖 file(GLOB) 自动收集
file(GLOB) 看似省事，但在真实协作和 CI 场景中容易出问题：
- 新文件加入目录后，CMake 不会自动 reconfigure —— 除非你加
CONFIGURE_DEPENDS，但该选项在 Ninja 和某些旧版本 Makefile 生成器中不支持 -
GLOB_RECURSE可能误扫build/下的中间生成文件（如build/gen/foo.cpp），导致编译失败或行为异常 - IDE（如 VS、CLion）无法感知
GLOB动态结果，源文件不会出现在项目树里，编辑/跳转/重构功能失效 - 审查代码时，无法从
CMakeLists.txt直观看出“这个可执行文件到底由哪些源组成”，可维护性差
如果真要批量管理，优先用 aux_source_directory()（仅限当前目录，不含子目录，且不匹配头文件），或明确列出子目录变量再拼接：set(SRC_LIST src/main.cpp src/utils.cpp)，然后 target_sources(app PRIVATE ${SRC_LIST})。
常见错误：头文件没被 IDE 收录或编译报 file not found
头文件本身不参与编译，但有两个关键点必须处理：
- 确保头文件路径被
target_include_directories()告知编译器，例如：target_include_directories(app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include) - 若希望头文件出现在 VS 的“Header Files”过滤器或 CLion 的 Project View 中，必须显式加入
target_sources()（哪怕只是INTERFACE）：target_sources(app INTERFACE include/utils.h) - 不要混用
include_directories()（全局作用）和target_include_directories()（目标级、推荐）；后者才能正确传递包含路径给依赖目标
漏掉其中任一环节，都会出现 “找不到头文件” 或 “头文件在 IDE 里不可见” 的问题，且错误信息往往不直接指向根源。
