macOS小版本更新后Ruby命令报错，核心是PATH重置或shell配置失效；需先运行which ruby、ruby -v && gem env home、echo $PATH筛查路径，再修复~/.zshrc中Ruby相关路径顺序，优先使用用户空间gem install --user-install，并确保rbenv/RVM初始化正确。
系统补丁（尤其是 macos 小版本更新，如 sonoma 14.5 → 14.6）常会重置 shell 配置、刷新 path 顺序、或触发 sip 对 /usr/local 的二次限制，导致 ruby、gem、pod 等命令突然报 command not found 或指向错误路径。核心不是 ruby 被删了，而是“找不到了”。
确认当前 Ruby 实际在哪、用的是哪个
先别急着重装，跑这几条命令快速定位：
-
which ruby—— 看终端调用的是哪个 ruby；如果是/usr/bin/ruby，说明没走你装的版本 -
ruby -v && gem env home—— 检查 Ruby 版本和 gem 安装目录是否匹配（比如 ruby 3.2.2 却显示 gem home 在/usr/local，大概率错配） -
echo $PATH | tr ':' '\n' | grep -E 'homebrew|rbenv|ruby'—— 快速筛查 Ruby 相关路径是否在 PATH 前段
修复 PATH 顺序与 shell 配置文件
补丁后常见问题是 ~/.zshrc 未被加载，或 PATH 被系统脚本覆盖。重点检查：
- 确认你用的是 zsh：
echo $SHELL，输出应为/bin/zsh - 打开
~/.zshrc，确保 Ruby 相关路径在最前面（越靠前优先级越高）：export PATH="/opt/homebrew/opt/ruby/bin:$PATH"export PATH="/opt/homebrew/lib/ruby/gems/3.2.0/bin:$PATH"
（Apple Silicon 用/opt/homebrew；Intel 用/usr/local） - 执行
source ~/.zshrc生效，再验证which ruby
绕过 SIP 权限冲突，用用户空间安装 gem
系统补丁后，sudo gem install 更容易失败，且污染环境。推荐统一走用户目录：
- 先清理旧的全局 gem：
gem uninstall cocoapods bundler rails - 配置 gem 使用用户目录：
gem install --user-install bundler - 把用户 bin 加进 PATH：
export PATH="$HOME/.gem/ruby/3.2.0/bin:$PATH"（路径按gem env home输出微调） - 之后所有项目都用
bundle install，不再依赖全局 gem
检查 rbenv / RVM 是否被“静音”
如果你用版本管理器，补丁可能让 shims 失效：
- rbenv 用户：运行
rbenv init - zsh，复制输出中eval "$(rbenv init - zsh)"这行，粘贴到~/.zshrc末尾，再source - RVM 用户：检查
~/.rvm/scripts/rvm是否存在，然后加[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"到~/.zshrc - 最后执行
rbenv versions或rvm list，确认当前版本已激活
