小版本补丁导致Ruby命令“消失”的核心原因是PATH中断、shim失效或Homebrew Portable Ruby被替换；需先用which ruby和/opt/homebrew/opt/ruby/bin/ruby -v验证Ruby真实状态，再修复~/.zshrc中brew shellenv及Ruby路径配置，最后重建gem与bundler绑定并重装ruby应对dyld或OpenSSL链接问题。
小版本补丁（如 macos sonoma 14.5 → 14.6）虽不跨大版本，但常悄悄重置 shell 配置、刷新 sip 策略或更新底层 dyld 路径缓存，导致 ruby 命令突然“消失”或报 command not found。核心不是 ruby 被删了，而是系统忘了它在哪——path 断了，shim 失效，或 brew 的 portable ruby 运行时被临时替换。
确认 Ruby 是否还在原位
别急着重装，先快速验证真实状态：
- 运行
which ruby—— 如果返回空或/usr/bin/ruby，说明当前 shell 没找到你装的 Ruby - 运行
/opt/homebrew/opt/ruby/bin/ruby -v（Apple Silicon）或/usr/local/opt/ruby/bin/ruby -v（Intel）—— 直接调用 Homebrew Ruby 二进制，看版本是否正常 - 运行
brew --prefix ruby—— 确认 Homebrew 仍识别 Ruby 安装路径，若报错则需brew reinstall ruby
修复被覆盖的 shell 初始化配置
小更新常清空或跳过 ~/.zshrc 中的 PATH 行，尤其当系统自动备份旧文件为 ~/.zshrc.pre-ventura 类似名时：
macOS Automator Services
下载
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
- 打开
~/.zshrc：nano ~/.zshrc - 确保含这三行（M1/M2 芯片）：
eval "$(/opt/homebrew/bin/brew shellenv)"export PATH="/opt/homebrew/opt/ruby/bin:$PATH"export PATH="/opt/homebrew/lib/ruby/gems/*/bin:$PATH" - 保存后执行
source ~/.zshrc，再试ruby -v和which ruby
重建 gem 与 bundler 的绑定关系
补丁更新可能让已安装的 gem shim 文件失效（尤其是 bundle 命令），即使 Ruby 可用，bundle install 仍报错：
- 先确认 Bundler 是否在当前 Ruby 下：运行
/opt/homebrew/opt/ruby/bin/ruby -S bundle -v - 若报错或版本旧，执行：
/opt/homebrew/opt/ruby/bin/ruby -S gem install bundler - 再重新生成 shim：
brew unlink ruby && brew link ruby - 最后验证：
bundle -v应输出版本号，且which bundle指向/opt/homebrew/lib/ruby/gems/*/bin/bundle
应对 dyld 或 OpenSSL 链接抖动
极少数补丁会更新系统级动态库（如 libSystem.B.dylib），导致 Ruby 编译时链接的 OpenSSL 或 Readline 找不到依赖：
- 运行
ruby -e "require 'openssl'"—— 若报cannot load such file -- openssl，就是链接断裂 - 不用降级 OpenSSL，直接重装 Ruby：
brew reinstall ruby - 若
brew自身报 dyld 错误（如libcrypto.3.dylib not found），先执行：brew uninstall --ignore-dependencies openssl@3 readline && brew install openssl@3 readline
