macOS安装Bundler、Jekyll遇Ruby目录权限错误求助

核心问题定位 #

你遇到的权限错误本质是：尽管安装了rbenv等Ruby版本管理工具，但终端仍在调用macOS自带的Ruby（2.6.x版本），而系统目录的写入权限被严格限制，导致无法安装gem。

第一步：验证当前Ruby环境 #

先在终端执行以下命令，确认当前使用的Ruby版本和gem路径：

ruby -v
gem env home

如果输出的Ruby版本为2.6.x，或gem路径指向/System/Library/Frameworks/Ruby.framework/...，说明第三方Ruby环境未生效。

第二步：修复rbenv的Shell配置（以zsh为例，bash操作类似） #

1. 打开终端配置文件：

open ~/.zshrc

2. 确保文件末尾添加了rbenv的初始化配置（没有则手动加入）：

export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init - zsh)"

3. 保存文件后，刷新终端配置：

source ~/.zshrc

4. 再次执行ruby -v，确认版本显示为3.2.2。

第三步：重新安装Bundler和Jekyll #

环境配置正确后，执行以下命令安装（绝对不要加sudo）：

gem install bundler jekyll

额外排查点（若上述步骤无效） #

• 检查终端是否为登录Shell：部分终端默认非登录Shell，会导致rbenv初始化脚本未执行。可在终端偏好设置中，将启动Shell改为/bin/zsh --login。
• 确认Ruby版本是否安装成功：执行rbenv versions，若3.2.2未列出，重新安装：

ruby-install ruby 3.2.2
rbenv global 3.2.2

• 清理旧环境变量：若之前配置过chruby等工具，需从.zshrc或.bashrc中移除相关配置，避免环境冲突。

内容的提问来源于stack exchange，提问作者Stephen Kiilu