创建React Native新项目时Ruby版本不匹配报错求助

1. 排查终端实际使用的Ruby环境 #

• 执行 echo $PATH 查看系统路径顺序，确认你安装的Ruby（3.0.2）路径是否排在系统自带Ruby（2.6.10）之前
• 执行 which ruby 查看当前生效的Ruby执行文件路径，判断是否为你设置的3.0.2版本路径

2. 修正版本管理器配置（以rbenv/rvm为例） #

如果你用rbenv： #

• 执行 rbenv versions 确认3.0.2已安装
• 执行 rbenv global 3.0.2 设置全局默认版本，再执行 rbenv rehash 刷新环境
• 完全关闭终端后重新打开，执行 ruby -v 验证版本是否生效

如果你用rvm： #

• 执行 rvm list 查看已安装的Ruby版本列表
• 执行 rvm use 3.0.2 --default 设置为默认版本
• 重启终端，执行 ruby -v 确认版本

3. 调整项目Gemfile的版本要求 #

• 进入新建的React Native项目目录，打开Gemfile文件
• 将其中的 ruby '2.7.5' 修改为 ruby '3.0.2'，或者直接注释掉该行（若项目允许兼容更高版本）
• 在项目目录下执行 bundle install 重新安装依赖

4. 检查shell配置文件 #

• 打开你的shell配置文件（如~/.zshrc、~/.bashrc或~/.bash_profile）
• 确认版本管理器的初始化代码已正确添加，比如rbenv需要添加：

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

• 保存配置后执行 source ~/.zshrc（对应你的shell文件），再重启终端验证

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