M1芯片Mac无法安装CocoaPods，React Native初始化失败

1. 彻底清理现有依赖残留 #

先清除所有可能导致冲突的旧版本组件：

• 卸载brew安装的CocoaPods：

  brew uninstall --cocoapods
  

• 清理gem安装的CocoaPods及ffi：

  sudo gem uninstall cocoapods ffi
  rm -rf ~/.cocoapods
  

• 清理Node相关残留：

  rm -rf ~/.nvm ~/.npm ~/.node-gyp
  

2. 配置终端Rosetta兼容模式 #

打开「访达」→「应用程序」→「实用工具」，找到「终端」右键选择「显示简介」，勾选「使用Rosetta打开」，重启终端。

3. 重新安装依赖（在Rosetta终端执行） #

• 更新brew：

  brew update
  

• 安装CocoaPods：

  brew install cocoapods
  

• 解决ffi编译失败问题，先安装依赖库再安装ffi：

  brew install libffi
  export LDFLAGS="-L/usr/local/opt/libffi/lib"
  export PKG_CONFIG_PATH="/usr/local/opt/libffi/lib/pkgconfig"
  sudo gem install ffi -- --with-cflags="-Wno-error=implicit-function-declaration"
  

4. 验证并初始化项目 #

• 确认CocoaPods安装成功：

  pod --version
  

• 初始化React Native项目：

  npx react-native init MyTestProject
  

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

  cd MyTestProject/ios
  pod install
  

额外排查点 #

• 确保Xcode已完成初始化（打开Xcode同意协议并安装组件）
• 建议使用nvm安装Node LTS版本：

  nvm install --lts
  nvm use --lts
  

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