Clang生成静态库需严格分离编译、归档、链接三步：用clang++ -c编译实现文件并指定头路径，ar rcs归档目标文件（macOS需ranlib），链接时-L与-l顺序不可颠倒，CMake中须显式声明STATIC并正确配置头路径与符号可见性。
Clang生成静态库不是“调个命令就行”的事，关键在于编译、归档、链接三步必须严格分离，漏掉 -c 或写错 ar 参数，轻则链接失败，重则符号全丢。
clang++ -c 编译源文件时必须加 -c 且不碰头文件
直接 clang++ MyClass.cpp 会尝试链接，报 undefined reference to `main'；把 MyClass.h 和 MyClass.cpp 一起传给 clang++ -c，会卡在“cannot compile 'MyClass.h' as C++ source”。
- 只对实现文件（
.cpp、.cc、.cxx）执行clang++ -c -std=c++17 -I./include MyClass.cpp -o MyClass.o -
-I./include必须带上，否则#include "MyClass.h"找不到 - 模板类全在头里？那就没法出
.o——静态库要的是定义，不是声明
ar rcs libxxx.a xxx.o 的三个字母一个都不能少
ar 不是“打包工具”那么简单，s（生成索引）漏了，链接时 undefined reference 查都查不到来源；c 没写，第一次运行会静默失败。
-
ar rcs libmylib.a MyClass.o util.o——r替换/插入，c强制创建，s写 symbol table - macOS 默认
ar不支持s，得补ranlib libmylib.a - Windows 上用
llvm-ar更稳，路径用正斜杠，避免 shell 转义问题
链接时 -L 和 -l 的顺序不能颠倒
clang++ 把 -lmylib 放 main.o 前面，就可能跳过该库的符号解析——链接器是单向扫描的，碰到未解决符号才回头找库。
- 正确：
clang++ main.o -L. -lmylib -o app - 错误：
clang++ -L. -lmylib main.o -o app（尤其多库依赖时更容易出问题） - 验证库是否真含符号：
ar -t libmylib.a看文件名，再nm -C libmylib.a | grep MyClass::func确认在T段
CMake 里 add_library 必须显式写 STATIC
哪怕你只写了 add_library(mylib mylib.cpp)，只要全局 BUILD_SHARED_LIBS=ON，Clang 就会静默生成 libmylib.so 而不是 .a，编译通过但链接炸。
- 必须写成
add_library(mylib STATIC mylib.cpp) - 头文件路径要用
target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)，PRIVATE不透出，include_directories()全局污染 - 库目标定义必须在可执行目标之前，
target_link_libraries(app PRIVATE mylib)才能继承头路径
最容易被忽略的其实是符号可见性：inline 函数、未显式实例化的模板、constexpr 成员函数，都不会进 .o，自然也不会出现在 .a 里——这时候看 nm 输出全是 U（undefined），不是路径或顺序问题，是代码本身没导出定义。
