Mac创建React Native项目遇Ruby版本不匹配问题求解决

核心问题 #

你本地已经安装了Ruby 3.1.2，但React Native CLI调用的是Mac系统默认的Ruby 2.6.8，导致Gemfile版本校验失败。本质是rbenv/rvm的环境变量未正确加载，或者CLI未读取到自定义Ruby的路径。

解决步骤 #

1. 确认版本管理器的环境变量配置 #

检查你的shell配置文件（_/.zshrc、/.bash_profile或~/.profile，取决于你用的shell）中是否添加了版本管理器的初始化代码：

• 若用rbenv，确保有以下内容：

  export PATH="$HOME/.rbenv/bin:$PATH"
  eval "$(rbenv init -)"
  

• 若用rvm，确保有以下内容：

  [[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
  

添加后执行source ~/.zshrc（对应你的配置文件名）重启终端环境，再执行which ruby，输出应为~/.rbenv/shims/ruby（rbenv）或~/.rvm/rubies/ruby-3.1.2/bin/ruby（rvm），而非系统默认的/usr/bin/ruby。

2. 为项目绑定指定Ruby版本 #

进入项目目录（或初始化前的目标目录），执行对应命令绑定版本：

• rbenv：

  rbenv local 3.1.2
  

  此命令会在目录下生成.ruby-version文件，后续进入该目录会自动切换到指定版本。

• rvm：

  rvm use 3.1.2 --default
  

  加上--default会将3.1.2设为全局默认版本，不加则仅当前会话生效。

执行完成后再次运行ruby -v，确认版本为3.1.2，再重新执行React Native初始化命令。

3. 手动安装Bundler并执行依赖安装 #

如果初始化仍失败，可手动处理Bundler：

1. 安装Bundler：

   gem install bundler
   

2. 进入项目的ios目录，执行：

   bundle install
   

   确保此过程使用的是正确的Ruby版本。

4. 强制指定Ruby路径执行初始化 #

若npx仍读取系统Ruby，可在初始化命令前明确指定Ruby路径：

• rbenv用户：

  PATH="$HOME/.rbenv/shims:$PATH" npx react-native init YourProjectName
  

• rvm用户：

  PATH="$HOME/.rvm/rubies/ruby-3.1.2/bin:$PATH" npx react-native init YourProjectName
  

5. 检查PATH优先级 #

执行echo $PATH，确认rbenv/rvm的shims/bin路径位于/usr/bin之前，确保自定义Ruby版本优先被系统调用。

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