clang 不生成静态库，仅编译 .cpp 为 .o；ar 才打包成 .a。必须用 clang++ -c 编译源文件（非头文件），加 -fpic 建议但非必需，ar rcs 生成符号表，cmake 中 add_library 必须显式写 static，链接时 -l 参数须置于目标文件之后。
Clang 本身不生成静态库，它只负责把 .cpp 编译成 .o；真正打包成 .a 的是 ar。漏掉 -c、混编头文件、或没写 STATIC，都会导致你拿到的不是静态库。
clang++ -c 编译实现文件时必须加 -c 且只传 .cpp
常见错误是直接 clang++ MyClass.h —— Clang 不处理头文件，不会输出任何目标文件；或者 clang++ -c MyClass.h MyClass.cpp，会报错 cannot compile 'MyClass.h' as C++ source。
-
-c是强制项：没有它，clang++ 默认尝试链接，报undefined reference to main - 只对
.cpp（或.cc、.cxx）文件执行编译，例如：clang++ -c -std=c++17 -fPIC math_utils.cpp -o math_utils.o - 如果函数全在头文件里（比如纯模板），那根本编不出
.o—— 静态库必须有已实例化的定义，不能只有声明 -
-fPIC不是必需，但建议加上：避免后续被误用于动态库场景，尤其跨平台时更稳妥
ar rcs 打包时必须带 s 参数生成符号表
用 ar rcs libmath.a math_utils.o 是最简可行命令；漏掉 s 会导致链接时报 undefined reference 却查不出原因——因为链接器找不到符号索引。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
-
r：插入或替换成员（replace） -
c：创建新归档（create），不提示 -
s：生成索引（symbol table），等价于后续再跑ranlib libmath.a - macOS 的
ar默认不支持s，得手动补：ar rc libmath.a math_utils.o && ranlib libmath.a - Windows 下推荐用 LLVM 自带的
llvm-ar，行为和 Unixar一致，但注意路径分隔符用/，别用\
CMake 中 add_library 必须显式写 STATIC
哪怕你设了 -DBUILD_SHARED_LIBS=OFF，只要 add_library(xlog xlog.cpp) 没写类型，CMake 就可能静默生成动态库——这是最常踩的坑。
- 正确写法：
add_library(xlog STATIC xlog.cpp)，头文件可一并列出触发依赖重编译 - 验证方法：构建后进
build/lib/目录，运行file libxlog.a，输出应为current ar archive，不是ELF shared object - 头文件路径必须用
target_include_directories(xlog PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)，否则下游#include "xlog.h"会报No such file or directory - 链接顺序必须是：先
add_library，再add_executable，最后target_link_libraries(test_xlog PRIVATE xlog)
链接时 -l 必须放在目标文件之后
即使 libmath.a 里真有符号，clang++ -L. -lmath main.o -o app 也可能失败；而 clang++ main.o -L. -lmath -o app 才能正常解析。
- 链接器从左到右扫描，遇到未解析符号才去后面的库中找；把
-lmath放前面，它还没看到main.o里的引用，就跳过了 - 检查库是否真含符号：
ar -t libmath.a看文件名，再用nm -C libmath.a | grep add确认函数出现在T段（已定义） - 如果函数用了
inline或模板但没显式实例化，符号就不会进.o，自然也不会进.a - C++ 名称修饰会影响匹配：用
nm -C查看可读名，避免调用方用了extern "C"而库内是 C++ mangled 名
最容易被忽略的是：静态库不包含头文件，也不自动暴露路径；哪怕 .a 文件生成成功，调用方找不到 #include 的头，整个封装就等于没做。
