Clang编译动态库必须加-fPIC，否则链接时报relocation错误；需用-shared链接，运行时通过LD_LIBRARY_PATH、-rpath或ldconfig解决库路径问题，符号需显式声明visibility=default。
Clang 编译动态库时必须加 -fPIC
不加 -fPIC 会导致链接时报错 relocation R_X86_64_32 against symbol 或类似提示。动态库代码必须位置无关，否则加载到任意内存地址会失败。x86_64 下尤其严格，即使你没看到错误，链接器也可能静默拒绝。
正确做法：
- 源码编译阶段就加
-fPIC：clang -fPIC -c foo.c -o foo.o - 链接成动态库时用
-shared：clang -shared foo.o -o libfoo.so - 不要试图用
-fPIE替代-fPIC—— 后者是为共享库设计的，前者用于可执行文件
链接时用 -L 和 -l，但运行时要解决 libfoo.so: cannot open shared object file
编译链接没问题，运行时报找不到库，说明动态链接器（ld-linux.so）在运行时没搜到你的 .so。这不是编译问题，是运行环境问题。
有三种常用解法，按优先级排序：
- 临时指定路径：
LD_LIBRARY_PATH=/path/to/your/lib ./a.out（仅调试用，别放进脚本或部署） - 编译时硬编码搜索路径：
clang main.c -L/path/to/lib -lfoo -Wl,-rpath,/path/to/lib -o app。注意-Wl,-rpath是把-rpath传给链接器，不是 clang 自己的选项 - 系统级注册：把库路径写进
/etc/ld.so.conf.d/mylib.conf，再运行sudo ldconfig。适合长期部署，但需要 root 权限
头文件和符号可见性容易被忽略
动态库里的函数默认是全局可见的，但如果你用了 static、__attribute__((visibility("hidden"))) 或编译时加了 -fvisibility=hidden，那链接时就会报 undefined reference —— 即使库文件存在、路径正确、名字也对。
检查方式：
- 看符号是否导出：
nm -D libfoo.so | grep your_function_name（-D只显示动态符号） - 如果没输出，说明函数没导出；加
__attribute__((visibility("default")))显式标记关键函数 - 头文件里声明的函数，最好和实现保持一致的 visibility 属性，避免头文件暴露了但实现藏起来了
macOS 上要用 .dylib 而不是 .so，且链接参数不同
Clang 在 macOS 默认生成 .dylib，强行用 .so 后缀会导致 dyld: Library not loaded。而且 -rpath 在 macOS 上对应的是 -install_name 和 -rpath 配合使用。
典型流程：
- 编译：
clang -fPIC -c foo.c -o foo.o - 生成 dylib：
clang -dynamiclib foo.o -o libfoo.dylib - 指定 install name：
clang -dynamiclib foo.o -install_name "@rpath/libfoo.dylib" -o libfoo.dylib - 链接时加：
clang main.c -L. -lfoo -Wl,-rpath,@executable_path/../lib -o app
macOS 的 @rpath 解析规则和 Linux 不同，@executable_path 是最稳妥的起点。
nm -D、ldd（Linux）或 otool -L（macOS）验证中间产物，比反复改编译命令更省时间。 
