Clang 不能直接编译多目录项目，因其仅为单文件前端，不解析目录结构、不自动发现源文件、不处理依赖；必须配合 CMake 等构建系统，由其分析结构、生成适配 Clang 的构建脚本，并通过 add_subdirectory 和 target_link_libraries 等机制正确管理多级目录与依赖。
Clang 能不能直接编译多目录项目？
不能。clang 和 clang++ 本身是单文件驱动的编译器前端，不解析目录结构、不自动发现源文件、不处理依赖顺序。你用 clang++ src/main.cpp src/utils/str.cpp 这种显式列出所有 .cpp 的方式可以工作，但一旦目录变深、文件增多、出现头文件跨目录引用，手动拼路径就极易出错或漏编。
为什么 CMake + Clang 是最稳妥的选择？
因为 CMake 不是编译器，而是“生成构建指令的工具”——它读取 CMakeLists.txt，分析目录结构和依赖关系，再生成适配 Clang 的构建脚本（如 Ninja 或 Makefile）。关键在于：CMake 原生支持多级子目录，且能通过 add_subdirectory() 显式纳入子模块。
- 子目录必须包含自己的
CMakeLists.txt，哪怕只有一行：add_library(utils STATIC utils.cpp) - 根目录的
CMakeLists.txt用add_subdirectory(src/utils)引入，之后就能在主目标中用target_link_libraries(main PRIVATE utils) - 确保设置
CMAKE_CXX_COMPILER为clang++，否则 CMake 可能默认调用系统g++ - 不要依赖
file(GLOB ...)自动收集源文件——它不感知新增文件，需手动重运行 CMake
常见错误：头文件找不到或链接失败
多目录项目最常卡在这两步，根源几乎都出在路径配置上：
-
#include "utils/string.h"报错？检查target_include_directories(utils PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})是否把子目录加进 include 路径 - 链接时报
undefined reference to 'xxx'？确认utils库是否被add_library()正确声明，并在主目标中用target_link_libraries()显式链接 - Clang 提示
unknown argument: '-fPIE'？这是 GCC 默认参数，CMake 在检测到 Clang 后通常会自动禁用，若仍有此错，手动在CMakeLists.txt中加set(CMAKE_POSITION_INDEPENDENT_CODE ON) - 子目录里有
.h但没.cpp？CMake 不会自动处理纯头文件目录，需用target_include_directories()单独导出路径
不写 CMake 的临时方案：用 shell 脚本递归收集 .cpp
仅限小型验证项目，不可用于工程化场景。Linux/macOS 下可用：
find src -name "*.cpp" -print0 | xargs -0 clang++ -std=c++17 -Isrc -o main
但要注意：
-
-Isrc让所有#include "xxx.h"都从src/开始找，要求头文件路径与目录结构严格匹配 - 没有依赖管理，改一个
.h文件不会触发相关.cpp重编译 - Windows 上需用 PowerShell 或 MSYS2 的
find，原生命令不兼容 - 一旦出现模板定义分离（.h + .tpp）、内联函数或预编译头，该命令立刻失效
真正要长期维护多目录 C++ 项目，绕不开 CMake 的目录建模能力——Clang 只负责最后一步“把 .o 编成可执行文件”，前面的组织、发现、依赖推导，得靠构建系统兜底。
