Clang生成动态库完整教程-C++-PHP中文网

clang生成动态库需按平台选用参数：macos/ios用-dynamiclib和-fpic，linux用-shared和-fpic，windows用__declspec(dllexport)；还需处理符号可见性、ios签名及架构匹配。

clang生成动态库完整教程

Clang 生成动态库不是“加个 -shared 就完事”，macOS 和 iOS 必须用 -dynamiclib，Linux 才认 -shared；不加 -fPIC 在 macOS/Linux 上会链接失败，Windows 则根本不用这个参数。

Clang 在 macOS 和 iOS 平台不支持 -shared 选项，强行使用会报错：unknown argument: '-shared'。系统只接受 -dynamiclib，且生成的后缀固定为 .dylib。

clang -dynamiclib -o libmath.dylib src/math.c -Iinclude 是正确写法
若源码含 Objective-C，需加 -x objective-c 和 -fobjc-arc
目标平台要显式指定，比如 iOS 模拟器：-target x86_64-apple-ios15.0；真机则用 aarch64-apple-ios
不指定 -isysroot 会导致头文件找不到，例如：-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS17.5.sdk

Linux 下动态库要求所有代码是位置无关的（PIC），否则 ld 链接时会拒绝加载：错误信息类似 relocation R_X86_64_32 against ... can not be used when making a shared object。

Clang 22.1.3

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

下载

编译阶段就要加 -fPIC：clang -fPIC -c src/utils.c -o utils.o
链接阶段用 -shared：clang -shared utils.o -o libutils.so
不能跳过 .o 直接从源码一步生成：clang -fPIC -shared src/utils.c -o libutils.so 可行，但不推荐——调试和复用目标文件更灵活
如果混用 C++，记得加 extern "C" 防名字修饰，否则 C 程序调用会 undefined symbol

Clang 默认把所有符号设为 hidden（尤其在 macOS/Linux），即使你写了函数，外部也看不到——nm -D libxxx.dylib 或 nm -D libxxx.so 查不到你的函数名。

C 语言头文件中加宏控制可见性：#define EXPORT __attribute__((visibility("default")))，然后声明 EXPORT int add(int, int);
C++ 中要在实现前加 extern "C" { EXPORT int add(...); }
Windows 不需要这个，但要用 __declspec(dllexport)；跨平台项目建议统一用宏封装
漏掉 visibility 设置，运行时会报 dlsym: symbol not found（动态加载场景）或链接时报 undefined reference（静态链接场景）

即使 clang -dynamiclib 成功生成了 .dylib，Xcode 项目里拖进去也大概率运行失败：iOS 系统强制要求动态库必须满足三项条件，缺一不可。

必须用 Apple Developer 证书签名：codesign -s "Apple Development: xxx" --force --deep libMyLib.dylib
必须作为 Embedded Binaries 加入 target，不能只放 Linked Frameworks and Libraries
App ID 必须开启 App Groups 或 Associated Domains（取决于用途），否则 dlopen 返回 NULL
模拟器生成的 dylib 无法在真机运行，架构不匹配；务必用 -target arm64-apple-ios 编译真机版