搭载M1芯片的macOS Monterey用rbenv安装Ruby3.0.4失败求助

一、修复Ruby安装失败（yaml扩展未编译）问题 #

M1芯片环境下，rbenv安装Ruby时可能无法自动识别libyaml依赖，导致yaml扩展编译失败。按以下步骤解决：

• 通过Homebrew安装libyaml依赖：

  brew install libyaml
  

• 指定libyaml路径重新安装目标Ruby版本（以3.0.4为例，3.1.2操作逻辑一致）：

  RUBY_CONFIGURE_OPTS="--with-libyaml=$(brew --prefix libyaml)" rbenv install 3.0.4
  

二、修复rbenv global设置不生效问题 #

ruby -v仍显示系统自带版本，多因rbenv初始化不完整或PATH优先级异常，按以下步骤排查：

1. 确认终端配置文件（zsh对应~/.zshrc）的初始化命令：
   打开~/.zshrc，确保存在以下内容，且放置在自定义PATH配置之后：

   eval "$(rbenv init - zsh)"
   

2. 手动加载配置并验证rbenv状态：
   执行命令使配置生效：

   source ~/.zshrc
   

   执行type rbenv，若输出类似rbenv is a shell function from /opt/homebrew/Cellar/rbenv/1.2.0/libexec/rbenv，说明初始化成功。
3. 确认Ruby版本安装与全局设置：
   执行rbenv versions，确认目标版本（如3.1.2）已完成安装；若未安装，先按第一个问题的方法完成安装。
   执行全局版本设置：

   rbenv global 3.1.2
   

   执行rbenv version，若输出3.1.2 (set by /Users/[你的用户名]/.rbenv/version)，说明设置生效。
4. 检查PATH优先级：
   执行echo $PATH，确认~/.rbenv/shims路径位于/usr/bin之前。若顺序错误，在~/.zshrc中添加：

   export PATH="$HOME/.rbenv/shims:$PATH"
   

   重新执行source ~/.zshrc后，再验证ruby -v输出。

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