如何解决React Native创建项目时Ruby版本不匹配报错

当创建React Native项目遇到 error Your Ruby version is 3.0.0, but your Gemfile specified 2.7.6 报错时，核心原因是项目依赖的Ruby版本与当前系统使用的版本不一致，以下是几种可行的解决办法：

方法一：用rbenv管理Ruby版本（推荐） #

rbenv是轻量型Ruby版本管理器，能快速在不同版本间切换：

• 若未安装rbenv，先执行安装命令：

  brew install rbenv ruby-build
  

  （Linux系统可使用对应包管理器，如apt/yum，或从GitHub克隆源码安装）
• 安装指定的2.7.6版本：

  rbenv install 2.7.6
  

• 在项目目录下设置局部版本（避免影响其他项目）：

  rbenv local 2.7.6
  

• 验证版本切换结果：

  ruby -v
  

  输出显示ruby 2.7.6p147后，即可重新执行React Native项目创建命令。

方法二：用rvm管理Ruby版本 #

若习惯使用rvm，操作步骤如下：

• 安装rvm：

  \curl -sSL https://get.rvm.io | bash -s stable --ruby
  

• 安装2.7.6版本：

  rvm install 2.7.6
  

• 切换至该版本：

  rvm use 2.7.6
  

• 验证版本无误后，重新创建项目即可。

方法三：临时修改Gemfile（不推荐） #

如果只是临时想跳过版本校验，可修改项目目录下的Gemfile，将ruby '2.7.6'改为当前系统的3.0.0版本。但这种方式可能导致后续iOS依赖安装失败，因为React Native部分原生依赖仅兼容指定Ruby版本，建议谨慎使用。

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