Mac安装Ruby 3.0.2报错Error running '__rvm_make -j8'如何解决

Error running '__rvm_make -j8'

• Xcode 命令行工具未安装、版本过旧或未激活许可，缺少编译必需的工具链
• Homebrew 依赖缺失或版本不兼容，Ruby 3.0.2 编译依赖的 openssl@1.1、readline、libyaml 等包未正确安装，或错误使用了 OpenSSL 3.x 等不兼容版本
• Apple Silicon（M1/M2 等）架构适配问题，未安装 Rosetta 2 导致 x86 架构的编译逻辑无法执行
• RVM 本地存在旧版本的编译缓存或残留安装文件，干扰本次编译流程
• 自定义环境变量存在冲突的编译参数，如 CFLAGS、LDFLAGS 等配置覆盖了 RVM 默认编译配置
• 编译线程数过高，部分设备硬件性能不足以支撑多线程并行编译，导致编译进程中断

方法1：重装Xcode命令行工具 #

• 卸载旧版本命令行工具：
  sudo rm -rf /Library/Developer/CommandLineTools
• 重新安装最新版本：
  xcode-select --install
• 安装完成后激活许可协议：
  sudo xcodebuild -license accept
• 安装完成后重新执行 Ruby 安装命令即可

方法2：指定兼容依赖版本安装 #

注意：Ruby 3.0.x 仅兼容 OpenSSL 1.1 版本，请勿使用 OpenSSL 3.x 系列版本

• 先更新 Homebrew 源并安装必备依赖：

brew update
brew install openssl@1.1 readline libyaml gmp

• 执行安装命令时手动指定依赖路径：

rvm install 3.0.2 --with-openssl-dir=$(brew --prefix openssl@1.1) --with-readline-dir=$(brew --prefix readline) --with-libyaml-dir=$(brew --prefix libyaml)

方法3：Apple Silicon设备专属适配方案 #

• 先安装 Rosetta 2 兼容层：
  softwareupdate --install-rosetta --agree-to-license
• 切换到x86架构执行安装命令：
  arch -x86_64 rvm install 3.0.2

方法4：清理缓存后重试 #

• 删除对应版本的残留文件和全部缓存：
  rvm remove 3.0.2 && rvm cleanup all
• 重新执行安装命令

方法5：降低编译线程数 #

报错中的-j8代表默认启用8线程并行编译，可手动调低线程数避免编译中断：

# 调整为4线程编译
rvm install 3.0.2 -j 4

如果仍报错可继续调低至-j 2重试

方法6：清空冲突环境变量 #

如果之前自定义过编译相关环境变量，可先清空变量再执行安装：

unset CFLAGS LDFLAGS CPPFLAGS
rvm install 3.0.2

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