用clang生成动态库需分两步：先用-fPIC -c编译各源文件为位置无关目标文件，再用-shared链接成libxxx.so；-fPIC必须加在编译阶段，否则链接报错；macOS用-dynamiclib，Windows用-shared生成.dll。

clang 编译多个源文件生成动态库的关键步骤

直接用 clang -shared 一次性编译多个 .c 或 .cpp 文件是可行的，但必须确保所有目标文件都参与链接，且不遗漏符号依赖。最稳妥的做法是分两步：先编译为位置无关的目标文件（.o），再链接成动态库。

• -fPIC 必须加在编译阶段（不是链接阶段），否则链接时会报错：relocation R_X86_64_32S against `xxx' can not be used when making a shared object
• 每个源文件都要单独用 clang -fPIC -c 编译，不能跳过 -c 直接编译进共享库——那样会隐式尝试链接，容易因未定义符号失败
• 动态库名建议用 libxxx.so 格式，Linux 下运行时加载器默认按此规则查找

具体命令示例（以 two.c 和 util.c 为例）

假设有 two.c（导出 add_two()）和 util.c（导出 square()），头文件 mathlib.h 声明了这两个函数：

clang -fPIC -c two.c -o two.o
clang -fPIC -c util.c -o util.o
clang -shared -o libmathlib.so two.o util.o

注意：-shared 只出现在最后一步；中间的 .o 文件必须都带 -fPIC 编译，哪怕其中某个源文件没调用外部函数也不能省。

Clang 22.1.3

Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。

下载

常见错误：忘记 -fPIC 或混用静态/动态编译选项

典型报错包括：

• cannot compile inline assembly with -fPIC：某些内联汇编不支持 PIC，需改用 -fPIE 或重写汇编逻辑
• undefined reference to `xxx'：可能是某个源文件漏编译，或函数未声明为 extern "C"（C++ 源码导出给 C 调用时）
• 生成的 .so 无法被 dlopen() 加载，报 undefined symbol：说明链接时漏了某个依赖的 .o，或该符号在源码中被 static 修饰导致不可导出

跨平台兼容性提醒

macOS 上要用 -dynamiclib 替代 -shared，输出后缀通常是 .dylib；Windows（Clang + MinGW）则用 -shared 生成 .dll，但需额外导出符号（如用 __declspec(dllexport) 或 .def 文件）。Linux 的 libxxx.so 在其他平台不能直接复用——动态库不具备二进制兼容性。

真正容易被忽略的是符号可见性控制：gcc/clang 默认导出所有非 static 全局符号，但大型项目常需用 -fvisibility=hidden 配合 __attribute__((visibility("default"))) 显式标记导出函数，否则可能意外暴露内部实现细节。