如何在Big Sur系统上安装兼容的高版本Ruby？

1. 修正Xcode Command Line Tools路径与头文件配置 #

• 检查当前CLT路径：

  xcode-select -p
  

  如果输出不是/Library/Developer/CommandLineTools，执行重置命令：

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

• 手动安装SDK头文件：
  打开CLT的头文件安装包（如果存在）：

  open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_11.pkg
  

  若找不到该包，需重新下载对应版本的Command Line Tools 12.2，确保安装完整。

2. 设置编译环境变量 #

安装Ruby前，通过环境变量指定编译器的头文件与SDK路径：

export SDKROOT=$(xcrun --show-sdk-path)
export CFLAGS="-I$SDKROOT/usr/include"
export CPPFLAGS="-I$SDKROOT/usr/include"

可将上述命令添加到~/.zshrc或~/.bash_profile中，避免每次安装重复设置。

3. 针对不同Ruby版本的编译参数调整 #

• Ruby 3.3.0：依赖较新的OpenSSL版本，若已通过Homebrew安装openssl@1.1，添加配置参数：

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

• Ruby 2.7.2：需指定兼容的Readline路径（若通过Homebrew安装）：

  RUBY_CONFIGURE_OPTS="--with-readline-dir=$(brew --prefix readline)" rbenv install 2.7.2
  

4. 清理缓存并重新安装 #

若之前编译失败残留缓存，先清理：

rm -rf ~/.rbenv/sources/3.3.0  # 替换为对应Ruby版本的路径

再执行上述带参数的安装命令。

5. 修复Clang版本路径问题 #

当前系统Clang版本为5.0.0，而CLT 12.2自带更高版本的Clang，需将CLT的bin目录优先加入PATH：

export PATH="/Library/Developer/CommandLineTools/usr/bin:$PATH"

同样将此命令添加到shell配置文件中，确保默认使用CLT的编译器。

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