M1芯片MacBook Pro安装React Native时CocoaPods依赖安装失败如何解决？

前置校验 #

• 确保已正确安装Xcode，且Command Line Tools配置正确，执行以下命令校验配置路径：
  xcode-select -p
• 若返回路径不为 /Applications/Xcode.app/Contents/Developer，执行以下命令切换：
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
• 所有操作均在非Rosetta模式的终端中执行

核心解决步骤 #

• 安装arm64架构适配的ffi依赖：
  sudo gem install ffi

若使用rbenv、rvm等Ruby版本管理工具，不需要添加sudo前缀执行

• 进入项目iOS目录手动执行安装：

cd ./AwesomeProject07/ios
arch -x86_64 pod install

异常排查 #

如果执行上述操作后仍报错，先清理缓存和旧配置后重试：

# 清理CocoaPods全局缓存
rm -rf ~/Library/Caches/CocoaPods
# 清理项目内Pod相关文件
rm -rf Pods
rm -rf Podfile.lock
pod deintegrate
# 更新本地Pod仓库索引
pod repo update
# 重新执行安装
arch -x86_64 pod install

长期优化（避免后续初始化项目重复报错） #

• 卸载旧版CocoaPods后重新安装适配M1的版本：

sudo gem uninstall cocoapods
sudo gem install cocoapods

• 你也可以将架构指定命令写入终端配置文件实现永久生效：
  • 若使用zsh终端，执行：echo "alias pod='arch -x86_64 pod'" >> ~/.zshrc && source ~/.zshrc
  • 若使用bash终端，执行：echo "alias pod='arch -x86_64 pod'" >> ~/.bash_profile && source ~/.bash_profile

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