rbenv安装Ruby时ruby-build报错‘The Ruby openssl extension was not compiled’如何解决？

1. 检查并更新Homebrew及OpenSSL #

• 更新Homebrew：

  brew update
  

• 安装兼容性更稳定的OpenSSL@1.1（部分Ruby版本对OpenSSL@3支持存在适配问题）：

  brew install openssl@1.1
  

• 强制链接OpenSSL@1.1，避免系统默认版本干扰：

  brew link --force openssl@1.1
  

  若遇权限报错，在命令前添加sudo重新执行。

2. 配置全局环境变量，让ruby-build优先识别正确的OpenSSL #

将以下内容添加到你的shell配置文件（~/.zshrc或~/.bash_profile，根据使用的shell选择）：

export PATH="/usr/local/opt/openssl@1.1/bin:$PATH"
export LDFLAGS="-L/usr/local/opt/openssl@1.1/lib"
export CPPFLAGS="-I/usr/local/opt/openssl@1.1/include"
export PKG_CONFIG_PATH="/usr/local/opt/openssl@1.1/lib/pkgconfig"

保存后重新加载配置文件：

# zsh用户执行
source ~/.zshrc
# bash用户执行
source ~/.bash_profile

3. 清理残留文件并重新安装Ruby #

• 删除之前失败安装的Ruby版本残留：

  rbenv uninstall 3.1.2
  

• 清理ruby-build的临时编译目录：

  rm -rf /var/folders/rf/fpyjcz390_s3_s72h94q2n100000gp/T/ruby-build.*
  

• 重新执行安装命令：

  rbenv install 3.1.2
  

4. 验证配置结果 #

安装完成后，检查Ruby是否正常加载OpenSSL：

rbenv global 3.1.2
ruby -r openssl -e "puts OpenSSL::VERSION"

若能正常输出OpenSSL版本号，说明配置成功。

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