Clang动态库从编译到调用完整教程-C++-PHP中文网

clang -dynamiclib 编译动态库时必须指定-target和-isysroot，否则默认生成elf格式导致链接失败；需匹配macos/ios平台、架构与sdk版本，并正确设置-rpath或install_name_tool以解决运行时库加载问题。

clang动态库从编译到调用完整教程

直接用 clang -dynamiclib -o libfoo.dylib foo.c 在 macOS/iOS 上大概率失败，不是语法错，而是目标平台缺失。Clang 默认不生成 Mach-O 动态库，它需要明确告诉编译器：你要为哪个系统、哪个架构、哪个 SDK 生成代码。

常见错误现象：ld: unknown option: -dylib 或 file not recognized: file format not recognized，本质是链接器收到 ELF 格式输入却试图生成 Mach-O。

对 macOS：加 -target x86_64-apple-macos13.0（版本按你实际 SDK 调整）
对 iOS 模拟器：用 -target x86_64-apple-ios16.0-simulator
对 iOS 真机：用 -target arm64-apple-ios16.0
必须配 -isysroot 指向 SDK 路径，例如 /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.0.sdk
-fobjc-arc（如果含 Objective-C）和 -dynamiclib 必须同时存在

运行 clang++ main.o -lfoo 报错 ld: library not found for -lfoo，不是库不存在，而是链接器根本没去查你放库的目录。

Clang 链接器按从左到右顺序解析参数，-L 只影响它**之后**出现的 -l。写成 -lfoo -L./libs 就无效；必须是 -L./libs -lfoo。

Clang 22.1.3

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

下载

路径用相对路径时，确保是相对于**执行 clang 命令时的当前工作目录**，不是源码目录
-L 后不能有空格，-L ./libs 错，-L./libs 对
macOS 上 dylib 名称必须带 lib 前缀和 .dylib 后缀，-lfoo 对应文件名是 libfoo.dylib
若库在系统路径（如 /usr/local/lib），需先运行 sudo install_name_tool -add_rpath /usr/local/lib main，否则运行时报 Library not loaded

macOS 从 10.11 开始禁用 DYLD_LIBRARY_PATH（除非关闭 SIP），所以设了也没用。这不是权限问题，是系统策略。

正确做法是让可执行文件“记住”去哪里找库：

用 nm -m libfoo.dylib | grep MyViewController 发现类名没出现，或者运行时报 unrecognized selector，大概率是符号问题。

确保头文件中类声明加了 __attribute__((visibility("default")))，否则默认隐藏
编译时加 -fvisibility=hidden 是默认行为，要显式暴露符号就得靠 attribute 或 -fvisibility=default（不推荐，会导出所有）
如果主工程用 ARC，动态库也必须用 -fobjc-arc；两者 ARC 状态不一致会导致 retain/release 错乱
Objective-C 类方法需在头文件中声明，且实现文件里不能漏掉 @implementation —— Clang 不像 Xcode 那样自动补全

真正卡住人的地方不在命令拼写，而在 Mach-O 的加载机制和 visibility 控制这两层隐式约束。一个 dylib 文件存在不等于它能被加载，能被加载不等于它的符号对主程序可见。每一步都得用 otool 和 nm 验证，而不是只看编译是否通过。