Ruby版本与Gemfile不匹配问题解决指南

在初始化 React Native 项目时遇到错误 Your Ruby version is 2.6.8, but your Gemfile specified 2.7.5？这是由项目中指定的 Ruby 版本与您系统当前使用的版本不一致导致的。常见于以下环境配置：

• macOS Monterey (12.6)
• Xcode 14.0.1
• React Native CLI 创建新项目

根本原因

React Native iOS 依赖 CocoaPods，而 CocoaPods 版本与 Gemfile 中指定的 Ruby 版本必须严格匹配。系统默认 Ruby 版本或错误配置会触发此错误。

---

永久解决方案：使用版本管理工具

推荐使用 rbenv 或 rvm 管理多个 Ruby 版本，这是最佳实践。

方案1：rbenv（首选）

安装rbenv

# 通过Homebrew安装
brew update
brew install rbenv ruby-build

# 初始化环境（Zsh用户）
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

# Bash用户将.zshrc替换为.bashrc

安装指定Ruby版本

# 安装Gemfile要求的Ruby版本（替换为实际版本号）
rbenv install 2.7.5

# 设为全局默认版本
rbenv global 2.7.5

# 验证版本
ruby -v  # 应显示2.7.5

方案2：rvm（替代方案）

# 安装RVM（需先卸载系统Ruby冲突）
curl -sSL https://get.rvm.io | bash -s stable
source ~/.zshrc

# 安装特定版本
rvm install 2.7.5

# 设为默认版本
rvm use 2.7.5 --default

工具选择建议

• rbenv：轻量级，适合大多数用户
• rvm：功能更全面，适合复杂需求

---

临时解决方案

若已完成项目创建但初始化失败，可尝试：

修改Gemfile兼容当前版本

在项目 ios/Gemfile 中将第一行修改为您的 Ruby 版本：

# ios/Gemfile
ruby '2.6.8'  # 修改此版本号与系统一致

手动安装依赖

进入 iOS 目录执行：

cd ios && bundle install
bundle exec pod install  # 安装pods

不推荐做法

直接修改系统 Ruby 版本或使用 sudo gem 命令可能导致系统组件兼容性问题。

---

环境验证与问题排查

检查关键配置

# 确认环境变量
echo $PATH          # 检查rbenv路径是否优先
which ruby          # 应指向 ~/.rbenv/shims/ruby
gem env home        # 确认GEM路径正确

常见错误修复

# 清除缓存后重启
rm -rf ~/Library/Caches/CocoaPods
sudo rm -rf /usr/local/bin/bundle  # 删除冲突的bundle
reboot                             # 重启计算机

---

最佳实践总结

1. 始终使用版本管理工具（rbenv/rvm）避免系统冲突
2. 创建新项目前执行 rbenv global 2.7.5 确保版本一致
3. 避免在命令中使用 sudo gem 防止权限问题

执行以上步骤后，重新创建 React Native 项目应能成功初始化：

npx react-native init AwesomeProject