1. 为什么需要升级MacOS自带的Ruby版本
MacOS系统默认预装的Ruby版本通常比较老旧，比如最新的MacOS Ventura系统自带的Ruby 2.6.10。这个版本发布于2022年4月，已经停止维护。在实际开发中，我们会遇到几个关键问题：
- 安全风险：旧版本不再接收安全更新，存在潜在漏洞
- 功能缺失：无法使用新版本Ruby的语言特性和性能优化
- 兼容性问题：现代Ruby生态的gem包可能要求最低Ruby 3.0+
重要提示：直接修改系统自带的Ruby可能影响系统稳定性，推荐通过Homebrew安装独立版本
2. 环境准备与版本检查
2.1 检查当前Ruby环境
在终端执行以下命令查看系统Ruby版本：
bash复制ruby -v
# 典型输出示例：
# ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.x86_64-darwin22]
2.2 安装Homebrew
如果尚未安装Homebrew，执行以下命令安装：
bash复制/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，将brew添加到PATH：
bash复制echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
3. Ruby安装与升级实战
3.1 通过Homebrew安装最新Ruby
执行以下命令安装最新稳定版Ruby：
bash复制brew install ruby
安装完成后检查brew管理的Ruby版本：
bash复制brew info ruby
# 输出示例：
# ==> ruby: stable 3.3.2 (bottled), HEAD
3.2 配置环境变量
关键步骤：将Homebrew的Ruby路径优先于系统Ruby。编辑shell配置文件（根据使用的shell选择）：
对于zsh用户：
bash复制echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export PATH="$PATH:/usr/local/lib/ruby/gems/3.3.0/bin"' >> ~/.zshrc
source ~/.zshrc
对于bash用户：
bash复制echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
echo 'export PATH="$PATH:/usr/local/lib/ruby/gems/3.3.0/bin"' >> ~/.bash_profile
source ~/.bash_profile
3.3 验证安装结果
执行以下命令确认版本切换成功：
bash复制which ruby
# 应输出：/usr/local/opt/ruby/bin/ruby
ruby -v
# 应输出类似：ruby 3.3.2 (2024-05-30 revision e5a195edf6) [x86_64-darwin22]
4. 高级配置与管理
4.1 使用rbenv管理多版本（推荐）
对于需要多Ruby版本切换的开发者，建议使用rbenv：
- 安装rbenv：
bash复制brew install rbenv ruby-build
- 初始化rbenv：
bash复制echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
- 安装指定Ruby版本：
bash复制rbenv install 3.3.2
- 设置全局版本：
bash复制rbenv global 3.3.2
4.2 Gem环境配置
为避免权限问题，建议配置gem安装路径：
bash复制echo 'export GEM_HOME="$HOME/.gem"' >> ~/.zshrc
echo 'export PATH="$GEM_HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
5. 常见问题排查
5.1 版本切换无效
症状：执行ruby -v仍显示旧版本
解决方案：
- 确认PATH配置正确：
bash复制echo $PATH | grep ruby
- 检查shell配置文件加载顺序
- 重启终端或执行
exec zsh
5.2 Gem命令找不到
症状：gem install报错"command not found"
解决方案：
- 确认gem路径在PATH中：
bash复制which gem
- 重新安装Ruby：
bash复制brew reinstall ruby
5.3 编译扩展失败
症状：安装native gem时出现编译错误
解决方案：
- 安装Xcode命令行工具：
bash复制xcode-select --install
- 确保有编译工具链：
bash复制brew install gcc make
6. 维护与升级建议
- 定期更新Ruby版本：
bash复制brew update && brew upgrade ruby
- 清理旧版本gem：
bash复制gem cleanup
- 使用bundler管理项目依赖：
bash复制gem install bundler
- 建议为每个项目创建独立的gem环境：
bash复制bundle config set --local path 'vendor/bundle'
我在实际使用中发现，通过Homebrew结合rbenv的方案最灵活可靠。特别是开发多个Ruby项目时，可以轻松切换版本。一个常见陷阱是忘记更新shell配置文件，导致新安装的Ruby不可用。建议每次修改PATH后，用type -a ruby命令验证优先级。