Xcode 15 React Native编译报错：linker command failed with exit code 1

开发者阿泽

2026-7-3

解决Xcode 15构建React Native应用时的“linker command failed with exit code 1”错误

针对你遇到的问题，结合Xcode 15的特性和React Native的适配要求，尝试以下针对性方案：

确认React Native版本兼容性
Xcode 15要求React Native版本至少为0.72.6、0.73.1或更高版本。运行npx react-native info查看当前RN版本，若低于要求，执行升级命令：
```
npx react-native upgrade
```
或参考官方升级文档完成版本迭代。

修改Podfile适配Xcode 15链接器
在项目根目录的Podfile末尾添加以下配置，调整链接器参数以兼容Xcode 15：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if target.name == "React-Core" || target.name.start_with?("React-")
      target.build_configurations.each do |config|
        config.build_settings["OTHER_LDFLAGS"] ||= []
        config.build_settings["OTHER_LDFLAGS"] << "-ld64"
      end
    end
  end
end

保存后重新执行：

pod deintegrate && pod install --repo-update

调整Xcode Build Settings
1. 打开Xcode项目，进入目标工程的Build Settings
2. 搜索Other Linker Flags，确保包含-ObjC，清理重复或冲突的冗余参数
3. 搜索Enable Bitcode，设置为No（部分第三方库暂不支持Bitcode，Xcode 15默认可能开启）
4. 检查LD_RUNPATH_SEARCH_PATHS，确保包含$(inherited) @executable_path/Frameworks @loader_path/Frameworks
彻底清理缓存
除删除Pods目录外，还需清理Xcode衍生数据：
```
rm -rf ~/Library/Developer/Xcode/DerivedData
```
然后在Xcode中执行Cmd+Shift+K清理构建文件夹，再重新构建。
排查第三方依赖兼容性
若错误截图指向特定第三方库的链接问题，优先更新该库到适配Xcode 15的版本；若库已停止维护，考虑替换为功能替代方案。