下面给你一份 在 macOS 上将 Ruby 升级到 3.2.0 或更高版本 的最推荐、最干净、最稳定的方案（兼容 Intel / M1 / M2 / M3 设备）。
不修改系统自带 Ruby，只额外安装新版 Ruby ——这是 Apple 官方建议的做法。

✅ 最推荐方式：使用 Homebrew 安装 Ruby（简单、稳定、无冲突）

1️⃣ 安装 Homebrew（如已安装可跳过）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2️⃣ 安装 Ruby 3.2 或更高版本

Homebrew 一般提供 Ruby 最新版本（如 3.3.x）

brew install ruby

你也可以指定版本（但 Homebrew 通常不再提供旧版本）。

3️⃣ 配置 PATH（关键步骤，否则 Ruby 仍是系统版本）

根据 CPU 结构不同，路径不同：

🍏 Apple Silicon (M1/M2/M3)

echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"' >> ~/.zshrc
source ~/.zshrc

💻 Intel Mac

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/usr/local/opt/ruby/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/usr/local/opt/ruby/include"' >> ~/.zshrc
source ~/.zshrc

4️⃣ 确认 Ruby 是否成功升级

ruby -v

你应该看到类似：

ruby 3.3.0 (2024-01) [arm64-darwin]

若仍显示 2.x → PATH 配置不正确。

5️⃣（可选）切换 gem 源为更快的镜像

如果你要装 CocoaPods，这一步建议做：

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

6️⃣ （可选）升级 gem、安装 cocoapods

gem update --system
gem install cocoapods

🚀 方案 B：用 rbenv 安装 Ruby（适合需要多个版本的开发者）

如果需要管理多个 Ruby 版本，建议使用：

brew install rbenv ruby-build

安装 Ruby 3.2：

rbenv install 3.2.0
rbenv global 3.2.0

查看版本：

ruby -v

⚠️ 注意：不要尝试“升级系统自带 Ruby”

macOS 的系统 Ruby 位于：

/usr/bin/ruby

这是受保护文件（SIP），不可升级、不可删除、不可修改，任何尝试替换都会导致系统问题。

正确做法 → 安装新版 Ruby，让 PATH 优先使用它。

好的阿杰！你说“希望”，我理解为 你希望我帮你生成一条“一键安装 Ruby 3.2+ 的自动脚本”。
我现在直接给你 一键脚本 + 使用说明，复制到终端执行即可。

🚀 Mac 一键升级 Ruby 到 3.2+ 的自动脚本（适配 M1 / M2 / M3 / Intel）

下面脚本会自动：

  1. 检测 Homebrew
  2. 自动安装 Ruby（最新版本 ≥3.2）
  3. 自动添加 PATH
  4. 自动切换 gem 源
  5. 自动验证 Ruby 版本

📦 一键安装脚本

把下面整段复制到终端执行即可：

#!/bin/bash

echo "🍎 开始升级 Ruby 到 3.2+ ..."

# 检查是否安装 Homebrew
if ! command -v brew &>/dev/null; then
  echo "📦 未检测到 Homebrew，开始安装..."
  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
else
  echo "✔ 已检测到 Homebrew"
fi

echo "🔧 更新 Homebrew..."
brew update

# 安装 ruby
echo "📥 正在安装 Ruby（3.2+ 或最新版本）..."
brew install ruby

# 判断芯片架构
ARCH=$(uname -m)
if [ "$ARCH" = "arm64" ]; then
  RUBY_PATH="/opt/homebrew/opt/ruby/bin"
  RUBY_LIB="/opt/homebrew/opt/ruby/lib"
  RUBY_INC="/opt/homebrew/opt/ruby/include"
else
  RUBY_PATH="/usr/local/opt/ruby/bin"
  RUBY_LIB="/usr/local/opt/ruby/lib"
  RUBY_INC="/usr/local/opt/ruby/include"
fi

# 添加 PATH
echo "🔧 配置 Ruby 环境变量..."
echo "export PATH=\"$RUBY_PATH:\$PATH\"" >> ~/.zshrc
echo "export LDFLAGS=\"-L$RUBY_LIB\"" >> ~/.zshrc
echo "export CPPFLAGS=\"-I$RUBY_INC\"" >> ~/.zshrc

source ~/.zshrc

echo "🌐 切换 gem 源到 Ruby China，加速安装..."
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

echo "✨ 升级 RubyGems..."
gem update --system

echo "🔍 检测 Ruby 版本..."
ruby -v

echo ""
echo "🎉 Ruby 已成功升级！你现在使用的是："
ruby -v

echo "📌 你已经可以继续安装 CocoaPods（如需要）："
echo "    gem install cocoapods"

🧪 使用方法

  1. 打开 终端 Terminal
  2. 粘贴脚本
  3. 回车执行
  4. 完成后输入：
ruby -v

应该看到：

ruby 3.2.x 或 ruby 3.3.x