Mac升级Ruby是为了避免CocoaPods安装失败、gem报错及依赖不兼容，必须切换至3.2.0+版本；推荐新手用Homebrew直接安装（无需编译），开发者用rbenv管理多版本；验证需确认ruby -v、gem -v和which ruby均指向新路径而非/usr/bin/ruby。
Mac终端升级Ruby环境是为了避免CocoaPods安装失败、gem命令报错或依赖版本不兼容，尤其当系统自带Ruby（2.6.x或更旧）已停止维护时，必须切换到3.2.0及以上版本才能正常使用现代开发工具。
用 Homebrew 安装全新 Ruby（推荐新手）
这一步操作起来很简单，直接在终端里逐行执行即可，全程无需编译，5分钟内完成。
先装 Xcode 命令行工具：运行 xcode-select --install，弹窗点“安装”并等待完成。
检查是否已装 Homebrew：输入 brew --version，有版本号输出就跳过安装；没有则运行国内镜像安装命令：/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
更新包索引并安装 Ruby：brew update → brew install ruby。
安装完成后，终端会提示类似 ==> Caveats 的路径信息——【这是关键路径，必须记下】。Apple Silicon（M1/M2/M3）路径通常是 /opt/homebrew/opt/ruby/bin，Intel 芯片则是 /usr/local/opt/ruby/bin。
把该路径加到 ~/.zshrc 开头（确保优先级最高）：
Apple Silicon 用户运行：echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
Intel 用户运行：echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc。
立即生效配置：source ~/.zshrc。
用 rbenv 管理多版本 Ruby（适合需频繁切换的开发者）
如果你同时要跑 Rails 7 项目（需 Ruby 3.1+）和旧脚本（需 2.7），rbenv 是更灵活的选择。
第一步：安装 rbenv 和 ruby-build 插件：brew install rbenv ruby-build。
第二步：初始化 rbenv 并写入 shell 配置文件。
对 zsh 用户，运行：echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc → source ~/.zshrc。
第三步：列出所有可安装版本：rbenv install -l，从中选一个 3.2.0 及以上版本，比如 3.3.4。
第四步：安装并设为全局默认：rbenv install 3.3.4 → rbenv global 3.3.4。
注意：rbenv 不会自动修改 PATH，它靠 shell 函数拦截 ruby 命令调用——所以必须确保 rbenv init 已正确加载，否则 which ruby 仍指向系统路径。
验证新 Ruby 是否生效
运行三行命令，全部通过才算成功：
ruby -v → 输出应为类似 ruby 3.3.4，不能是 ruby 2.6.10。
gem -v → 版本号需与 Ruby 匹配（如 3.5.6），且路径中不含 /System/ 或 /usr/bin/。
which ruby → 输出必须是 /opt/homebrew/opt/ruby/bin/ruby（Homebrew 方式）或 /Users/xxx/.rbenv/shims/ruby（rbenv 方式），绝不能是 /usr/bin/ruby。
