React Native新项目克隆后iOS构建出现CoreGraphics相关未定义符号链接错误

看起来你在Apple M1芯片的Mac上跑React Native 0.63.5项目时，碰到了CoreGraphics相关Swift符号未定义的链接错误，而且试了加库、清Derived Data、重装Pods这些常规操作都没起色——这事儿大概率是旧版RN和新版Xcode、Apple Silicon的兼容性不匹配闹的，毕竟RN 0.63.5是2021年的老版本，对M1和Xcode 16.2的支持本来就很有限。下面给你几个针对性的修复方案，你可以挨个试试：

1. 降级Xcode到兼容版本（最核心的修复手段） #

React Native 0.63.5官方适配的Xcode版本是12.0~13.x，你现在用的Xcode 16.2版本太高了，它自带的Swift 5.10的二进制接口（ABI）和旧RN项目依赖的Swift库完全不兼容，这才导致CoreGraphics的符号链接失败。

你可以从Apple官方开发者资源页面下载Xcode 12.5.1或13.4.1（这两个版本对RN0.63的支持最稳定），下载后给不同版本的Xcode重命名（比如Xcode_12.5.1.app），再通过命令切换默认Xcode：

sudo xcode-select -s /Applications/Xcode_12.5.1.app/Contents/Developer

2. 给M1芯片配置Rosetta兼容设置 #

如果暂时不想降级Xcode，可以试试给项目加Apple Silicon适配配置：

（1）调整Xcode项目构建设置 #

打开项目的Build Settings：

• 把Architectures设置为Standard Architectures (arm64, x86_64)
• Debug模式下，将Build Active Architecture Only设为Yes
• 在Excluded Architectures中，给模拟器添加arm64（即Excluded Architectures[sdk=iphonesimulator*] = arm64）

（2）给Podfile加M1适配脚本 #

在项目根目录的Podfile末尾添加以下代码，强制模拟器用x86_64架构编译：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # 强制模拟器使用x86_64架构
      config.build_settings['ARCHS[sdk=iphonesimulator*]'] = 'x86_64'
      # 指定兼容的Swift版本
      config.build_settings['SWIFT_VERSION'] = '5.3'
    end
  end
end

然后执行命令重新安装Pods：

pod deintegrate && pod install && pod update

3. 彻底清理项目缓存 #

除了你已经试过的步骤，再做一次更彻底的缓存清理：

# 清理Pod全局缓存
pod cache clean --all
rm -rf ~/Library/Caches/CocoaPods

# 重置React Native缓存
npx react-native start --reset-cache

# 删除Xcode Derived Data
rm -rf ~/Library/Developer/Xcode/DerivedData

# 清理Xcode构建文件夹
xcodebuild clean -project YourProject.xcodeproj -alltargets

4. 检查Swift版本与链接器设置 #

在Xcode项目的Build Settings里：

• 找到Swift Language Version，设置为5.3（RN0.63.5发布时对应的稳定Swift版本）
• 找到Other Linker Flags，添加-lswiftCoreGraphics和-ObjC，确保链接器能正确找到CoreGraphics的Swift符号

5. 切换到兼容的Node.js版本 #

RN0.63.5官方推荐的Node.js版本是12.x~14.x，你当前用的Node 16.20.2虽然理论上兼容，但可能存在隐性依赖冲突。可以用nvm切换版本：

nvm install 14.21.3
nvm use 14.21.3

切换后重新执行npm install或yarn install，再尝试构建项目。

如果以上方法都无效，建议考虑升级React Native版本（比如升到0.68+，这个版本开始正式支持Apple Silicon和较新的Xcode），不过这需要做一些代码适配工作。

内容来源于stack exchange