CMake用Clang构建静态库需显式指定编译器、强制声明STATIC类型、用target_include_directories(PUBLIC)暴露头路径、确保add_library在add_executable之前且链接顺序正确；漏掉任一环节会导致链接失败或头文件找不到。
Clang生成静态库项目，CMake配置本身和GCC无本质区别，关键在于**显式指定Clang工具链、确保STATIC类型不被覆盖、头文件路径与链接顺序必须严格匹配**；用错BUILD_SHARED_LIBS或漏掉target_include_directories的PUBLIC，编译会通过但链接失败或报xlog.h: No such file or directory。
怎么让CMake用Clang而不是系统默认GCC
不能只靠环境变量，必须在CMake配置阶段强制指定。否则即使clang++ --version能跑，CMake仍可能调GCC。
- 命令行方式（推荐）：
cmake -S . -B build -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang - 在
CMakeLists.txt顶部加（仅限调试，不建议进版本库）：set(CMAKE_CXX_COMPILER clang++)，但需确保它出现在project()之前 - Windows上用MSVC+ClangCL时，要额外加
-T ClangCL和-A x64，否则add_library(... STATIC)会静默生成DLL
add_library必须写STATIC，且不能依赖BUILD_SHARED_LIBS
BUILD_SHARED_LIBS是全局开关，一旦设为ON，所有未显式声明类型的add_library都会变成动态库——这是静态库项目最常踩的坑。
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 正确写法：
add_library(xlog STATIC xlog.cpp xlog.h)，把头文件也列进去可触发依赖重编译 - 错误写法：
add_library(xlog xlog.cpp)，此时若-DBUILD_SHARED_LIBS=ON，生成的是libxlog.so而非.a - 验证方法：构建后进
build/lib/目录，Linux下file libxlog.a应输出current ar archive，不是ELF ... shared object
头文件路径必须用target_include_directories(PUBLIC)
静态库不打包头文件，调用方必须知道接口声明在哪。用include_directories()是全局污染，PRIVATE又不透出，只有PUBLIC才对。
- 正确写法：
target_include_directories(xlog PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include) - 错误现象：测试程序
#include "xlog.h"报错，但ls include/xlog.h明明存在 - 如果头文件在子目录如
include/xlog/xlog.h，则路径写${CMAKE_CURRENT_SOURCE_DIR}/include，包含时用#include "xlog/xlog.h"
链接顺序和target_link_libraries作用域不能错
CMake解析是顺序敏感的：库目标必须在可执行目标之前定义，且target_link_libraries的作用域决定了头文件能否被下游继承。
- 必须先写
add_library(xlog STATIC ...)，再写add_executable(test_xlog test_xlog.cpp)，否则报target xlog not found - 链接时写
target_link_libraries(test_xlog PRIVATE xlog)即可，因为只是单个可执行文件用；若test_xlog本身又被其他库链接，则需改为PUBLIC或拆成INTERFACE传递 - 跨平台注意：Windows下静态库后缀是
.lib，但CMake内部统一用目标名xlog，无需写xlog.lib
最容易被忽略的是Clang的-fPIC问题：静态库本身不需要位置无关代码，但如果你后续要把这个静态库再链接进动态库，就必须在编译静态库源码时加set_property(TARGET xlog PROPERTY POSITION_INDEPENDENT_CODE ON)，否则Linux下链接动态库会报relocation R_X86_64_32 against ... can not be used when making a shared object。
