本质是命令查找链断裂，需重建ruby运行时→gem工具链→项目依赖三层路径；先用which ruby、ruby -v、gem env home和head -1 $(which pod)定位问题，优先用rbenv安装并全局启用新版ruby（如3.2.2），再卸载重装pod等工具，最后补全~/.zshrc中的brew、ruby和rbenv path。
macos 升级或重装后 ruby 路径被覆盖，本质是命令查找链断裂——终端找不到正确的 ruby 可执行文件，或已安装的工具（如 pod、rails）仍指向旧路径。核心不是重装 ruby，而是重建「ruby 运行时 → gem 工具链 → 项目依赖」三层可信路径。
确认当前 Ruby 来源和路径是否可信
先别动手改，用三行命令快速定位问题根源：
-
which ruby：若输出/usr/bin/ruby，说明你仍在用系统自带 Ruby（SIP 锁定、不可写、版本老旧，必须切换） -
ruby -v和gem env home：两者路径应完全一致，且不能含/System/Library/或/usr/local/lib/（这些目录升级后常被清空或权限收紧） -
head -1 $(which pod)：检查脚本首行是否硬编码了已失效路径（如#!/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/bin/ruby）
优先用 rbenv 隔离并接管 Ruby 环境
rbenv 轻量、无侵入、不 hook shell，适合多数开发场景，能彻底绕过系统路径干扰：
- 通过 Homebrew 安装：
brew install rbenv ruby-build - 初始化 shell（zsh 用户）：
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc && source ~/.zshrc - 安装稳定版（如 3.2.2）：
rbenv install 3.2.2 && rbenv global 3.2.2 - 验证：
ruby -v应显示新版本，which ruby指向~/.rbenv/shims/ruby
修复已损坏的 Ruby 工具命令（如 pod、jekyll）
即使 Ruby 环境已切换，旧命令仍可能残留错误 shebang。分两步清理：
- 卸载旧工具：
gem uninstall cocoapods jekyll bundler（不加 sudo） - 在新 Ruby 下重装：
gem install cocoapods jekyll bundler——此时生成的pod命令会自动绑定到 rbenv 的 ruby - 若仍报错，手动修复脚本头：
vim $(which pod)，把第一行改为#!/usr/bin/env ruby，保存后chmod +x $(which pod)
补全 PATH 并防止下次升级丢失
系统更新常清空 ~/.zshrc，导致 brew 或 rbenv 路径失效。确保以下三行都在 ~/.zshrc 中：
-
eval "$(/opt/homebrew/bin/brew shellenv)"（Apple Silicon）或eval "$(/usr/local/bin/brew shellenv)"（Intel） -
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"（Homebrew Ruby 二进制路径） -
export PATH="$HOME/.rbenv/bin:$PATH"（rbenv 自身命令路径）
保存后运行 source ~/.zshrc，再检查 echo $PATH 是否包含上述路径。
