本质是底层依赖链断裂，需重建ruby运行时、编译工具链（openssl/readline）与gem管理器的可写可隔离执行链：先用which ruby和gem env home定位来源，修复path及shell初始化，再卸载重装冲突库，最后按需重装ruby或指定依赖路径。
系统版本更新后 ruby 编译环境“路径崩溃”，本质不是 ruby 坏了，而是底层依赖链断了——ruby 运行时、编译工具链（如 openssl、readline）、gem 包管理器三者之间因 macos 升级出现路径错位或库链接失效。重点不是重装 ruby，而是重建可写、可验证、可隔离的执行链。
先确认 Ruby 来源和实际运行路径
很多问题源于误用系统 Ruby（/usr/bin/ruby），它被 SIP 锁死、版本老旧、无法安装带 C 扩展的 gem（如 nokogiri、ffi）。执行以下命令快速定位：
-
which ruby → 若输出
/usr/bin/ruby，说明你正踩在雷区 -
ruby -v && gem env home → 两者路径必须一致，且不能含
/System/Library/或/usr/local/（除非你明确用 Homebrew 管理） - echo $PATH | grep -E "(homebrew|rbenv|ruby)" → 检查关键路径是否在搜索顺序前列
修复 PATH 和 shell 初始化（尤其升级后常被清空）
macOS 升级（如 Sonoma → Sequoia）会重置 ~/.zshrc，导致 brew 安装的 Ruby 或 rbenv shim 不在 PATH 中。按芯片类型补全：
- M1/M2/M3 芯片：确保 ~/.zshrc 包含
eval "$(/opt/homebrew/bin/brew shellenv)"export PATH="/opt/homebrew/opt/ruby/bin:$PATH"export PATH="/opt/homebrew/lib/ruby/gems/3.2.0/bin:$PATH" - Intel 芯片：路径前缀改为
/usr/local - 若用 rbenv：必须有
eval "$(rbenv init - zsh)"，且source ~/.zshrc后运行rbenv rehash
重建编译依赖链（OpenSSL / Readline / libffi）
报错如 cannot load such file -- openssl、ld: library not found for -lssl，说明 Ruby 编译时链接的动态库已被系统更新移除或路径失效：
- 先卸载冲突项：
brew uninstall --ignore-dependencies openssl@3 readline sqlite3 libffi - 再干净重装：
brew install openssl@3 readline sqlite3 libffi - 如果已用 Homebrew 安装 Ruby，强制重新链接：
brew reinstall ruby（它会自动探测新装的 OpenSSL 路径） - 若用 rbenv 安装 Ruby（如 3.2.2），重装时指定依赖：
RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@3)" rbenv install 3.2.2
绕过编译失败：临时禁用 OpenMP 或强制使用系统库
某些 gem（如 nokogiri、re2）在 Apple Silicon 上升级 Xcode CLT 后会因 -fopenmp 报错，或找不到系统级头文件：
- 全局禁用 OpenMP：
echo 'export OPENMP_DISABLE=1' >> ~/.zshrc && source ~/.zshrc - 安装 nokogiri 时用系统库（跳过编译）：
bundle config build.nokogiri --use-system-libraries - 确保 Xcode 命令行工具就绪：
xcode-select --install，再运行sudo xcode-select --switch /Library/Developer/CommandLineTools
