M1芯片Mac配置React Native时PyCharm/WebStorm安装CocoaPods报错如何解决

报错核心原因 #

M1芯片架构下直接使用gem安装CocoaPods存在兼容性问题，同时当前使用的Node.js v17属于非长期支持版本，和React Native模板依赖匹配度低，双重因素导致创建失败。

具体解决步骤 #

• 卸载原有gem安装的CocoaPods残留：
  执行命令：
  sudo gem uninstall cocoapods
  出现版本选择提示时选择全部卸载即可。
• 安装适配M1架构的CocoaPods
  优先通过适配M1的Homebrew安装，执行命令：
  brew install cocoapods
  安装完成后执行pod --version验证，正常输出版本号即为安装成功。
• 切换Node.js到长期支持版本
  建议使用v16或v18的LTS版本，可通过nvm管理Node版本，执行命令：
  nvm install 18 --lts
nvm alias default 18
  执行node -v确认版本切换成功。
• 重新创建项目
  删除之前创建失败的项目文件夹，重新打开PyCharm/WebStorm启动React Native项目创建向导即可，此时向导会跳过CocoaPods安装步骤，自动执行依赖安装。
  如果后续执行iOS编译时仍提示pod相关错误，可手动进入项目ios目录执行：
  arch -arm64 pod install
  完成后再启动项目即可。

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