macOS系统更新后Ruby报错主因是环境依赖链断裂：SIP锁定系统Ruby、Homebrew Ruby未入PATH、gem/bundler上下文错位、OpenSSL等库不兼容或Portable Ruby下载失败；修复需先确认Ruby来源（which ruby/ruby -v/gem env home三者路径一致），再补全~/.zshrc中brew shellenv及Ruby/gem bin路径，最后重建gem与bundler（gem install bundler、bundle install --full-index），必要时brew reinstall ruby或切换镜像源。
macos 系统更新后 homebrew 相关 ruby 报错，通常不是 ruby 坏了，而是环境链断了：系统自带 ruby 被 sip 锁死、homebrew 安装的 ruby 不在 path 里、gem 或 bundler 的上下文错位、底层库（如 openssl）版本不匹配，甚至 homebrew 自身的 portable ruby 下载失败。修复重点是理清来源、补全路径、重建上下文。
确认你用的是哪个 Ruby
先别急着重装，运行这三行命令，看输出是否一致且合理：
-
which ruby —— 如果返回
/usr/bin/ruby，说明还在用系统旧版（Sonoma 仍是 2.6.x），它受 SIP 保护，不能装 gem； - ruby -v —— 推荐版本应 ≥ 3.2；
-
gem env home —— 这个路径必须和
which ruby所在目录属于同一套环境（比如都指向/opt/homebrew/opt/ruby或~/.rbenv/versions/3.2.2），否则 gem 会装到错地方。
补全 PATH 和 shell 初始化
系统更新常清空或覆盖 ~/.zshrc，导致 Homebrew 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"（暴露 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 库被破坏，直接重装：brew reinstall ruby
处理 Homebrew 自身异常
常见报错如 Failed to upgrade Homebrew Portable Ruby 或 curl: (22) 404，本质是它内置的 Ruby 镜像源不同步：
- 临时切回官方源更新：
git -C $(brew --repo) remote set-url origin https://github.com/Homebrew/brew - 或手动清理缓存：
rm -f ~/Library/Caches/Homebrew/portable-ruby-*.tar.gz - 国内用户可配置镜像源提升稳定性（如中科大、清华源），避免反复超时
