macOS更新后Ruby环境崩溃主因是依赖链重置：SIP锁定系统Ruby、Homebrew路径失效、OpenSSL/Readline库不兼容、shell配置被覆盖、PATH错乱；需先确认Ruby来源（which ruby/ruby -v/gem env home三者路径一致且指向用户可写目录），再补全~/.zshrc中brew shellenv、Ruby bin及gem bin路径，最后重建gem与bundler环境（gem install bundler、bundle install --full-index），必要时brew reinstall ruby或切换Homebrew镜像源。
macos 系统更新后 ruby 环境崩溃，根本不是 ruby 本身坏了，而是系统底层依赖链被重置或错位：sip 锁定系统 ruby、homebrew 的 ruby 路径失效、openssl/readline 库版本不兼容、shell 配置（如 ~/.zshrc）被覆盖、path 顺序错乱。修复关键在于确认来源、补全路径、重建上下文，而不是盲目重装。
先搞清你用的是哪个 Ruby
运行下面三行命令，看输出是否一致且合理：
-
which ruby—— 如果是/usr/bin/ruby，说明还在用系统自带的旧版（Sonoma 仍是 2.6.x），它受 SIP 保护，不能装 gem； -
ruby -v—— 版本应 ≥ 3.1（推荐 3.2+）； -
gem env home—— 路径必须和which ruby所在目录属同一套环境（比如都指向~/.rbenv/versions/3.2.2或/opt/homebrew/opt/ruby），否则 gem 会装到错地方。
补全 PATH 和 shell 初始化
系统更新常清空 ~/.zshrc，导致 brew 或 rbenv 安装的 Ruby 不在搜索路径里。打开它：
nano ~/.zshrc
确保包含以下内容（Apple Silicon/M1/M2 用 /opt/homebrew；Intel 用 /usr/local）：
-
eval "$(/opt/homebrew/bin/brew shellenv)"（启用 Homebrew 命令） -
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"（暴露 Homebrew Ruby 可执行文件） -
export PATH="/opt/homebrew/lib/ruby/gems/*/bin:$PATH"（暴露 gem 安装的命令，如pod、rails） - 如果是 rbenv 用户：
eval "$(rbenv init - zsh)"
保存后执行 source ~/.zshrc，再验证 ruby -v 和 which ruby。
重建 gem 和 bundler 运行时
系统更新会让已编译的 gem（尤其含 C 扩展的，如 nokogiri、openssl）失效，Bundler 也可能与 Gemfile.lock 不匹配：
- 先装或升级 Bundler：
gem install bundler - 进项目目录，删掉缓存：
rm -rf vendor/cache tmp/ - 强制刷新依赖：
bundle install --full-index - 若报
cannot load such file -- openssl，说明 Ruby 编译链接的 OpenSSL 库被系统更新破坏，直接重装 Ruby：brew reinstall ruby
应对 Homebrew 自身异常
常见报错如 Failed to upgrade Homebrew Portable Ruby 或 curl: (22) 404，本质是 Homebrew 内置的 Ruby 镜像源不同步：
- 临时切回官方源：
git -C $(brew --repo) remote set-url origin https://github.com/Homebrew/brew - 再执行：
brew update && brew upgrade - 国内用户可加镜像加速：
brew tap-new homebrew/core && brew tap-pin homebrew/core（配合中科大或清华源）
