使用RVM/rbenv升级Ruby 2.6.10至3.0.0失败求助

问题概述 #

• 尝试通过RVM升级Ruby从2.6.10到3.0.0，执行ruby --version始终显示旧版本，已完成rvm get stable、rvm install ruby --latest、rvm use ruby --default操作，清理RVM、重启Shell、检查PATH后问题依旧。
• 执行rvm install 3.0.0时触发编译错误：

  Error running '__rvm_make -j8', please read /Users/apple/.rvm/log/1703760048_ruby-3.0.0/make.log
  There has been an error while running make. Halting the installation.
  

  日志核心错误为OpenSSL相关编译失败：

  make[1]: *** [ext/openssl/all] Error 2
  make: *** [build-ext] Error 2
  

• 切换到rbenv安装同样失败，报错：

  BUILD FAILED (macOS 13.6.1 on x86_64 using ruby-build 20231225)
  

排查与解决步骤 #

1. 修复OpenSSL依赖（核心解决方向） #

macOS 13+自带的OpenSSL版本与Ruby 3.0.0不兼容，需指定兼容版本编译：

• 用Homebrew安装OpenSSL 1.1：

  brew install openssl@1.1
  

• RVM安装Ruby时指定OpenSSL路径：

  rvm install 3.0.0 --with-openssl-dir=$(brew --prefix openssl@1.1)
  

• rbenv安装Ruby时指定OpenSSL路径：

  RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@1.1)" rbenv install 3.0.0
  

2. 彻底清理旧编译缓存 #

• RVM清理：

  rvm cleanup all
  rm -rf ~/.rvm/src/ruby-3.0.0/
  

• rbenv清理：

  rm -rf ~/.rbenv/sources/3.0.0/
  rm -rf ~/.rbenv/versions/3.0.0/
  

3. 验证Shell环境变量优先级 #

• 检查PATH顺序，确保RVM/rbenv路径在系统Ruby路径之前：

  echo $PATH
  

  需确认~/.rvm/bin（RVM）或~/.rbenv/shims（rbenv）位于/usr/bin之前。
• 重新加载Shell配置：

  source ~/.zshrc  # Zsh用户
  # 或
  source ~/.bash_profile  # Bash用户
  

4. 确认默认版本生效 #

• RVM设置默认版本：

  rvm use 3.0.0 --default
  rvm alias create default 3.0.0
  

• rbenv设置默认版本：

  rbenv global 3.0.0
  

• 验证版本：

  which ruby
  ruby --version
  

5. 降级Xcode Command Line Tools（备选方案） #

Ruby 3.0.0发布时间较早，可能与最新版Xcode Command Line Tools不兼容，可尝试降级到14.3版本：

sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install

（若需指定版本，可前往苹果开发者网站下载对应pkg安装）

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