Xcode集成C/C++库报错：Symbol(s) not found for architecture x86_64

Hey，我碰到过好几次这种情况——明明部署目标是iOS11+（已经淘汰32位），却还是报Symbol(s) not found for architecture x86_64。其实这个报错和32位没关系，x86_64是Mac模拟器的64位架构，问题出在模拟器编译环节。下面是几个你可以一步步排查的方向：

1. 确认C/C++库是否支持x86_64架构 #

x86_64是Mac模拟器的目标架构，如果你的库只编译了真机用的arm64，那模拟器上自然找不到符号。

• 用终端命令检查库的架构支持：

  lipo -info /path/to/your/library.a
  

  如果输出里没有x86_64，就得修改库的编译配置：
  • 若库是Xcode项目：打开库的Target设置，找到Architectures，确保勾选x86_64（或者选Standard Architectures）。
  • 若库是CMake/Makefile构建：在构建脚本里添加x86_64的编译参数，比如CMake里设置CMAKE_OSX_ARCHITECTURES="arm64;x86_64"。

2. 检查桥接文件的符号声明是否正确 #

C的名字修饰（name mangling）会让符号名变得复杂，导致OC代码找不到对应的符号，这时候需要用extern "C"包裹C接口：

// 桥接文件里的写法
extern "C" {
    void your_cpp_function();
    // 如果是类，需要封装成C风格的接口暴露给OC
}

另外，还要检查库的头文件里有没有static或inline修饰符——这些修饰符会让符号变成局部的，外部无法调用，得去掉或者调整为全局可见。

3. 核对iOS项目的Build Settings配置 #

打开你的iOS项目Target的Build Settings，检查这几个关键点：

• Architectures：确认Valid Architectures包含x86_64（虽然iOS11+默认不包含，但模拟器编译必须要有）。
• Build Active Architecture Only：如果设为Yes，确保当前编译目标是模拟器；或者直接改成No，让Xcode编译所有支持的架构。
• Link Binary With Libraries：确认已经把你的C/C++库添加到这个列表里，或者在Other Linker Flags里加上-l[库名]（比如库叫mylib就加-lmylib）。

4. 清理缓存后重新构建 #

Xcode的缓存经常会搞出奇怪的编译问题，试试这些操作：

• 执行Product > Clean Build Folder（快捷键Cmd+Shift+K）。
• 删除Derived Data：打开Xcode > Settings > Locations > Derived Data，点击文件夹图标后删掉对应项目的缓存文件夹。
• 先重新构建C/C++库，再构建iOS项目。

5. 检查库的条件编译逻辑 #

有些库会根据目标平台做条件编译，比如只在真机上编译某些函数。你可以搜一下库源码里的TARGET_OS_IPHONE、TARGET_IPHONE_SIMULATOR这类宏，看看是不是把x86_64架构的符号给排除了，调整条件让模拟器也能包含这些代码。

内容的提问来源于stack exchange，提问作者user4296481