Mac 升级和管理Ruby

在 Mac 上升级 Ruby，强烈建议不要直接去动 macOS 系统自带的 Ruby（位于 /usr/bin/ruby），因为系统自带的版本是给 macOS 系统工具使用的，直接修改可能会引发系统权限问题或破坏系统依赖。

最标准、最优雅的做法是使用 Homebrew 配合 Ruby 版本管理工具（如 rbenv）来安装和管理最新的 Ruby 版本。

以下是完整的升级步骤：

第一步：安装或更新 Homebrew

如果你还没有安装 Homebrew，请先打开终端并运行以下命令安装。如果已经安装，建议先更新一下：

brew update

第二步：使用 rbenv 安装最新版 Ruby

rbenv 是一个轻量级的 Ruby 版本管理器，可以让你的电脑同时存在多个 Ruby 版本，并随时切换。

1. 安装 rbenv 和 ruby-build 插件：

brew install rbenv ruby-build

1. 查看当前可安装的 Ruby 版本列表：

rbenv install -l

(你会看到一长串版本号，挑选最新的稳定版，例如 3.4.9 或 4.0.5。) 3. 安装指定的 Ruby 版本：

# 这里以安装 4.0.5 为例（你可以换成当前最新的稳定版本号）
rbenv install 4.0.5

第三步：设置全局默认版本

安装完成后，将刚刚安装的版本设置为全局默认版本：

rbenv global 4.0.5

第四步：配置环境变量（关键步骤）

为了让系统优先使用 rbenv 下载的 Ruby，而不是系统自带的旧版本，你需要将 rbenv 初始化脚本写入你的 Shell 配置文件中。

现代 Mac 默认使用 zsh，请根据你的 Shell 运行对应的命令：

如果你使用的是 Zsh（Mac 默认）

运行以下命令，将配置写入 ~/.zshrc：

echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

如果你使用的是 Bash

如果你手动改成了 Bash，请运行：

echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
source ~/.bash_profile

第五步：验证升级是否成功

最后，检查一下当前的 Ruby 路径和版本：

# 检查版本
ruby -v

# 检查路径
which ruby

• 预期输出版本：应该是你刚刚安装的 4.x.x。
• 预期输出路径：应该类似于 /Users/你的用户名/.rbenv/shims/ruby，而不是 /usr/bin/ruby。

提示： 升级 Ruby 后，如果需要安装诸如 cocoapods 等工具，建议直接运行 gem install cocoapods 即可。因为此时的 gem 已经归属到你的 rbenv 环境下，不再需要在前面加 sudo 了！