clang编译多文件项目时，cmakelists.txt必须显式列出所有源文件，不可依赖file(glob)自动收集；需在add_executable()中明确指定路径，或用add_subdirectory()分目录管理；指定clang编译器须在configure阶段通过set()或-d参数设置，而非仅靠环境变量；头文件路径须用target_include_directories()正确配置public/private作用域。
Clang编译多文件项目时，CMakeLists.txt 必须显式列出所有源文件
Clang 本身不改变 CMake 的源文件管理逻辑，但多文件项目容易因遗漏文件导致链接失败或符号未定义。CMake 不会自动扫描 src/ 目录下的所有 .cpp 文件——除非你主动用 file(GLOB_RECURSE ...)，而这在增量构建中可能失效。
正确做法是：在 add_executable() 或 add_library() 中明确写入每个源文件路径（相对项目根目录），或按子目录分组管理。
add_executable(myapp src/main.cpp src/utils.cpp src/core/log.cpp)- 若源文件分散在多个子目录，建议在对应子目录下各放一个
CMakeLists.txt，用add_subdirectory()引入，避免根目录配置过长 - 不要依赖
file(GLOB ...)自动收集，它不会触发重新 configure —— 改了源文件名或增删文件后，CMake 可能仍用旧的文件列表编译
指定 Clang 编译器必须在 configure 阶段完成，不能只靠环境变量
仅设置 CC=clang CXX=clang++ 环境变量，对 CMake Tools 插件或 cmake -S . -B build 命令无效。CMake 在首次 configure 时就固化编译器路径，后续修改环境变量无影响。
生效方式只有两种（任选其一）：
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 在
CMakeLists.txt开头附近写：set(CMAKE_C_COMPILER clang)set(CMAKE_CXX_COMPILER clang++) - 或在命令行 configure 时传参：
cmake -S . -B build -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ - VSCode 中使用 CMake Tools 时，点击状态栏「Select a Kit」→ 手动选中含 Clang 的 kit（如
Clang 18.1.3 x86_64-pc-linux-gnu），它会自动注入对应变量
头文件路径不配对会导致 Clang 报错 “No such file or directory”
Clang 对 include 路径更严格，尤其在跨目录引用时。比如 src/main.cpp 包含 #include "utils.h"，而 utils.h 实际在 include/utils.h，就必须告诉 Clang 去哪找。
关键不是 include_directories()（已过时），而是用现代写法：
- 对可执行目标
myapp，加：target_include_directories(myapp PUBLIC ${CMAKE_SOURCE_DIR}/include) - 如果
utils.h在src/utils.h，且main.cpp同在src/，则用：target_include_directories(myapp PRIVATE $<build_interface:>)</build_interface:> - 注意
PUBLIC/PRIVATE语义：PUBLIC 表示该路径也会透传给链接myapp的其他 target；PRIVATE 更安全，仅限本 target 内部使用
CMakePresets.json 配合 Clang 多文件项目最稳，但路径必须真实存在
VSCode + CMake Tools 默认读取 CMakePresets.json，里面写的编译器路径一旦错误（比如写成 /usr/bin/clang-15 但系统只有 clang-18），configure 直接失败，报错 CMake Error: Could not create named generator 或更隐蔽的 Compiler not found。
检查和配置要点：
- 运行
which clang和which clang++，把输出路径原样填进 preset 的"cacheVariables"里 - 确保
"binaryDir"是相对路径（如"${sourceDir}/out/build/clang"），且该目录无需预先创建 —— CMake 会自动建 - 多文件项目建议为不同 build 类型（debug/release）设不同 preset，避免 debug 构建污染 release 输出
target_include_directories() 没配对、或源文件没列全。别信“自动发现”，亲手写进去才可靠。
