配置Ruby on Rails本地环境遇权限及编译错误求助

核心问题分析 #

你的问题根源是系统自带Ruby仍被优先调用，而非rbenv管理的Ruby版本，同时缺少编译原生扩展所需的开发工具，导致安装失败。

分步解决方案 #

1. 修复rbenv环境变量，确保其优先生效 #

• 打开~/.zshrc，移除之前添加的export GEM_HOME="$HOME/.gem"（rbenv会自动为每个Ruby版本管理gem目录，手动设置会引发冲突）
• 在~/.zshrc中添加或确认以下配置（确保在PATH相关配置之前）：

  eval "$(rbenv init - zsh)"
  

• 重新加载配置：

  source ~/.zshrc
  

2. 确认rbenv管理的Ruby为当前活跃版本 #

• 查看已安装的Ruby版本：

  rbenv versions
  

• 设置默认使用的Ruby版本（替换<your-ruby-version>为你通过rbenv安装的版本，比如3.2.2）：

  rbenv global <your-ruby-version>
  

• 验证当前Ruby路径（应指向rbenv的shims目录）：

  which ruby
  

  正确输出应为：/Users/<username>/.rbenv/shims/ruby

3. 解决原生扩展编译失败问题 #

编译racc等gem需要Xcode Command Line Tools的头文件，执行以下步骤：

• 安装或重置Xcode Command Line Tools：

  xcode-select --install
  # 若已安装，执行重置
  sudo xcode-select --reset
  

• 确保SDK路径正确：

  sudo xcode-select -s /Library/Developer/CommandLineTools
  

4. 重新安装Rails #

完成上述配置后，执行安装命令：

gem install rails

• 验证安装：

  rails --version
  

  此时应显示你安装的Rails版本，而非系统未安装的提示。

补充说明 #

• 之前where rails返回多条记录是因为每次用系统Ruby执行gem install rails时，rbenv会自动生成shims条目，但实际并未在rbenv管理的Ruby环境中安装Rails，导致调用时出错。
• 永远不要用sudo gem install rails，这会修改系统Ruby的gem目录，引发权限和版本冲突问题。

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