Mac（10.13.3）安装Rails时gem报错求助

嘿，我来帮你捋捋这个安装问题～你提到用sudo gem install rails没解决还可能踩了坑，确实，系统自带的Ruby权限很敏感，乱用sudo容易搞乱目录权限，咱们一步步排查：

1. 先确认Ruby环境是否靠谱 #

Mac 10.13.3自带的Ruby版本可能比较老旧，而且属于系统级资源，直接操作容易出权限问题。建议用Ruby版本管理工具（比如rbenv或rvm）来管理独立的Ruby环境，避免干扰系统Ruby：

• 先检查当前Ruby版本：ruby -v，如果显示的是/usr/bin/ruby开头的系统Ruby，那大概率是权限或版本不兼容的问题。
• 安装rbenv（推荐）：先通过Homebrew安装brew install rbenv，然后配置环境变量（跟着终端提示的步骤来），接着安装一个适配Rails的Ruby版本，比如rbenv install 2.7.6（Rails 6.x适配这个版本，你可以根据需求选），最后设置全局版本rbenv global 2.7.6，重启终端后再尝试安装Rails。

2. 修复被sudo搞乱的gem目录权限 #

如果你已经用过sudo执行gem命令，可能导致gem安装目录的所有者变成root，普通用户无法读写，先修复权限：

sudo chown -R $(whoami) $(gem env gemdir)
sudo chown -R $(whoami) ~/.gem

执行完这两个命令后，再用普通用户身份执行gem install rails试试。

3. 切换RubyGems源解决网络问题 #

默认的rubygems.org在国内访问可能不稳定，导致依赖下载失败，换成国内镜像源：

# 添加国内镜像并移除默认源
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
# 确认源是否设置成功
gem sources -l

输出应该只有https://gems.ruby-china.com/，之后再执行gem install rails。

4. 获取详细错误日志定位问题 #

如果还是报错，执行带verbose参数的安装命令，获取完整错误信息：

gem install rails -V

这个命令会输出每一步的执行细节，比如是某个依赖gem（比如Nokogiri、Puma）编译失败，还是下载超时，根据具体错误再针对性解决。比如如果是编译失败，大概率是缺少Xcode命令行工具：

xcode-select --install

弹出安装窗口后完成安装，再重试。

内容的提问来源于stack exchange，提问作者Fisher Coder