React Native安装FontAwesome后npm run ios卡顿停滞问题求助

可能原因 #

• M1 Mac的arm64架构与FontAwesome的iOS依赖编译逻辑不兼容，导致Xcode构建时资源占用过高或陷入循环
• Xcode的Derived Data深层缓存未清理，残留信息干扰新编译流程
• 安装的FontAwesome版本与当前React Native版本存在兼容性冲突

可行解决方案 #

1. 用Rosetta模式运行Xcode #

• 打开Finder，找到应用程序里的Xcode
• 右键Xcode → 显示简介 → 勾选「使用Rosetta打开」
• 重启Xcode后，重新执行npm run ios

2. 彻底清理所有构建缓存 #

• 关闭Xcode
• 执行命令删除Xcode全局缓存：rm -rf ~/Library/Developer/Xcode/DerivedData
• 删除项目本地构建文件：rm -rf ios/build
• 进入ios目录重新安装pod：cd ios && pod install && cd ..
• 再执行npm run ios

3. 更换兼容的FontAwesome版本 #

• 卸载当前版本：npm uninstall @fortawesome/react-native-fontawesome
• 根据你的RN版本选择稳定版，比如RN 0.70+可安装0.3.0版本：npm install @fortawesome/react-native-fontawesome@0.3.0
• 重新执行pod安装和构建命令

4. 在Podfile中添加架构排除配置 #

• 打开ios/Podfile，找到post_install块，修改为：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
    end
  end
end

• 执行cd ios && pod install && cd ..后再尝试构建

5. 更新React Native到稳定版 #

• 如果你的RN版本较旧，可能存在M1兼容漏洞，执行npm install react-native@latest更新
• 更新完成后同步执行pod install，再尝试构建

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