直接用homebrew安装ruby是最稳妥方式，先装xcode命令行工具和homebrew（国内用户可用镜像源），再执行brew update和brew install ruby，接着根据芯片类型将对应路径（如/opt/homebrew/opt/ruby/bin）写入~/.zshrc并source生效，最后用ruby -v、gem -v和which ruby验证是否成功切换至新版。
直接用 homebrew 安装 ruby 是 macos 上最稳妥、最省心的方式，尤其适合新手和日常开发。它绕开系统 ruby 的限制，版本新、路径明确、权限干净，还能自动适配 apple silicon（m1/m2/m3）或 intel 芯片。
安装前的基础准备
确保终端能正常运行命令行工具：
- 先装 Xcode 命令行工具：在终端里执行 xcode-select --install，按提示点“安装”即可
- 检查是否已有 Homebrew：输入 brew --version，有输出说明已装好；没有就运行安装命令
- 国内用户若发现官网安装慢，可换国内镜像源：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
用 Homebrew 安装 Ruby
Homebrew 默认安装的是最新稳定版 Ruby（如当前为 3.3.x），无需编译，几分钟就能完成：
- 更新包索引：brew update
- 安装 Ruby：brew install ruby
- 安装完成后，注意看终端最后的提示，例如：
==> Caveats
里面会告诉你 Ruby 的实际安装路径（比如 /opt/homebrew/opt/ruby/bin 或 /usr/local/opt/ruby/bin），这个路径要加进环境变量
配置环境变量（关键一步）
不配置这步，终端仍会调用系统自带的旧 Ruby（通常是 2.6.x），导致后续 gem 或 CocoaPods 出错：
- 确认你用的是什么 Shell：macOS Catalina（10.15）及以后默认是 zsh，配置文件是 ~/.zshrc；老系统可能用 bash，对应 ~/.bash_profile
- 把 Homebrew 的 Ruby 路径加到 PATH 前面（优先级更高）：
对 zsh 用户，运行：
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
（Apple Silicon Mac）
或
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
（Intel Mac） - 立即生效：source ~/.zshrc
验证是否成功
运行两行命令，看输出是否为你刚装的版本（不是系统自带的 2.6.x）：
- ruby -v → 应显示类似 ruby 3.3.4
- gem -v → 应显示匹配的 gem 版本（如 3.5.x），且路径中不含 /System/ 或 /usr/bin/
- 顺带检查：which ruby 输出应为 /opt/homebrew/opt/ruby/bin/ruby（或 /usr/local/opt/ruby/bin/ruby），不是 /usr/bin/ruby
