创建React Native CLI项目遇Ruby版本不匹配等错误求助

核心问题分析 #

你本地终端执行ruby -v显示3.0.0，但React Native CLI调用的是系统自带的Ruby 2.6.10，而项目Gemfile要求2.7.6，导致Bundler安装失败；同时存在RubyGems版本过低和目录权限警告。

解决步骤 #

1. 调整Shell环境变量，让自定义Ruby版本优先调用 #

系统自带Ruby路径优先级高于你安装的版本，需修改PATH顺序：

• 打开Shell配置文件（zsh用户为~/.zshrc，bash用户为~/.bash_profile或~/.bashrc）
• 若使用rbenv，添加以下内容：

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

  若使用rvm，添加以下内容：

  export PATH="$HOME/.rvm/bin:$PATH"
  [[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
  

• 保存后执行source ~/.zshrc（对应你的配置文件）生效，重新打开终端执行which ruby，确认输出为自定义Ruby路径（如~/.rbenv/shims/ruby）而非系统路径。

2. 安装Gemfile要求的Ruby 2.7.6版本 #

通过版本管理器安装指定版本：

• rbenv用户：

  rbenv install 2.7.6
  rbenv local 2.7.6  # 在项目目录执行，设置本地版本
  

• rvm用户：

  rvm install 2.7.6
  rvm use 2.7.6  # 项目目录执行临时切换，加--default可设为全局默认
  

执行ruby -v确认版本已切换为2.7.6。

3. 升级RubyGems版本 #

执行报错提示的命令修复版本bug：

gem update --system 3.2.3

4. 修复目录权限警告 #

解决/Users/jcs/projetos目录权限过高问题：

chmod 755 /Users/jcs/projetos

5. 重新创建React Native项目 #

完成以上配置后，再次执行RN项目创建命令，即可正常完成初始化流程。

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