Mac M1搭建React Native环境：安装Bundler遇版本及环境错误

问题原因 #

初始化项目时，React Native模板的Gemfile指定了Ruby 2.7.6，但系统当前使用的是3.0.0版本，导致Bundler安装失败，进而触发iOS环境配置错误提示。

解决步骤 #

• 安装Ruby版本管理工具rbenv（M1 Mac兼容性更优）

  brew install rbenv ruby-build
  

• 配置shell环境，将rbenv加入PATH：
  • 若使用zsh：

    echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
    source ~/.zshrc
    

  • 若使用bash：

    echo 'eval "$(rbenv init - bash)"' >> ~/.bash_profile
    source ~/.bash_profile
    

• 安装指定版本的Ruby：

  rbenv install 2.7.6
  

• 设置Ruby版本：
  • 全局生效（所有项目默认用2.7.6）：

    rbenv global 2.7.6
    

  • 仅当前项目生效（进入项目根目录执行）：

    rbenv local 2.7.6
    

• 验证版本是否正确：

  ruby -v
  

  输出应显示ruby 2.7.6p219或类似版本号。
• 修复iOS目录下的依赖：
  1. 进入项目的iOS目录：

     cd project/ios
     

  2. 安装对应版本的Bundler：

     gem install bundler -v "$(grep -A 1 "BUNDLED WITH" Gemfile.lock | tail -n 1)"
     

  3. 安装iOS依赖：

     bundle install
     

• 回到项目根目录，重新启动项目：

  npx react-native run-ios
  

M1 Mac额外注意事项 #

确保Homebrew是原生ARM版本（安装路径为/opt/homebrew），若之前安装的是x86版本，需卸载后重新安装ARM版Homebrew，避免Ruby安装时出现架构兼容问题。

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