为何macOS仍用系统Ruby而非Homebrew版本？如何切换？

API 探路者

2026-7-9

解决Homebrew Ruby优先级问题

首先明确：whereis工具是从系统预设的路径数据库查找文件，不会参考当前用户的$PATH，所以它的输出不代表实际生效的Ruby版本，不用纠结这个。重点看which ruby和ruby -v的结果。

下面是具体解决步骤：

确认Homebrew Ruby已安装
执行以下命令检查：
```
brew list ruby
```
如果提示“Error: No such keg: /opt/homebrew/Cellar/ruby”，先安装Ruby：
```
brew install ruby
```
修正shell配置文件
macOS默认使用zsh，所以编辑~/.zshrc（如果用bash则编辑~/.bash_profile），确保Homebrew Ruby的bin目录被放在$PATH最前端：
```
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
```
注意：如果之前装过rbenv、rvm这类版本管理工具，它们可能会覆盖PATH顺序，需要暂时禁用或调整配置，让Homebrew的路径优先级更高。
刷新shell配置
执行命令让配置立即生效，或者直接重启终端：
```
source ~/.zshrc
```
验证生效状态
执行以下命令确认实际使用的Ruby路径：
```
which ruby
```
正常输出应该是/opt/homebrew/opt/ruby/bin/ruby，再检查版本：
```
ruby -v
```
此时显示的应该是Homebrew安装的Ruby版本。
排查别名/函数覆盖
如果以上步骤无效，检查是否有shell别名或函数覆盖了ruby命令：
```
type ruby
```
如果输出包含alias ruby=...或ruby is a function，找到对应的配置行删除即可。
可选：配置gem路径
Homebrew安装的Ruby的gem二进制文件也需要加入PATH，避免使用系统gem：
```
# 替换3.3.0为你实际安装的Ruby版本号
echo 'export PATH="/opt/homebrew/lib/ruby/gems/3.3.0/bin:$PATH"' >> ~/.zshrc
```
可以通过ls /opt/homebrew/lib/ruby/gems/查看具体的版本目录。