React Native初始化项目遇Ruby版本不匹配问题求助

问题场景 #

本地环境检测结果：

• which ruby 输出 -> /Users/User/.rbenv/shims/ruby
• ruby -v 输出 -> ruby 2.7.5p203 (2021-11-24 revision f69aeb8314) [x86_64-darwin21]
• which bundle 输出 -> /Users/User/.rbenv/shims/bundle
• bundle -v 输出 -> Bundler version 2.1.4

执行npx react-native init MyProject时触发错误：

✖ Installing Bundler
错误信息：Bundler::RubyVersionMismatch: Your Ruby version is 2.6.10, but your Gemfile specified 2.7.5

解决步骤 #

1. 锁定rbenv的Ruby版本 #

执行以下命令将全局或本地Ruby版本设置为2.7.5：

# 设置全局版本
rbenv global 2.7.5

# 若仅需针对当前项目目录生效，执行：
rbenv local 2.7.5

重启终端后，再次执行ruby -v确认版本已切换为2.7.5。

2. 重装适配当前Ruby版本的Bundler #

先卸载现有Bundler：

gem uninstall bundler

再安装对应版本的Bundler：

# 安装指定的2.1.4版本
gem install bundler -v 2.1.4

# 或安装兼容2.7.5的最新版本
# gem install bundler

安装完成后，执行bundle -v和which bundle，确认版本正确且路径指向/Users/User/.rbenv/shims/bundle。

3. 清理缓存后重新初始化项目 #

执行命令清理React Native缓存：

npx react-native clean

随后重新执行初始化命令：

npx react-native init MyProject

4. 检查shell配置确保rbenv生效 #

确认你的shell配置文件（如~/.zshrc或~/.bashrc）包含rbenv初始化脚本：

# 针对zsh用户
echo 'eval "$(rbenv init -)"' >> ~/.zshrc

# 针对bash用户
echo 'eval "$(rbenv init -)"' >> ~/.bashrc

保存后执行source ~/.zshrc（或对应bash文件），重启终端后验证环境。

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