macOS通过Homebrew安装asdf后安装Ruby提示版本不存在如何解决

核心原因 #

该报错的根本原因是asdf默认未内置Ruby版本管理插件，无法识别Ruby的版本源，也无法完成安装操作，重新安装asdf本身无法解决该问题。

解决步骤 #

• 第一步：安装asdf Ruby管理插件
  执行命令：
  asdf plugin add ruby
• 第二步：安装Ruby编译前置依赖（macOS环境必须）
  通过Homebrew安装编译所需的依赖库，避免后续安装Ruby时出现编译失败问题：
  brew install openssl readline libyaml zlib
• 第三步：更新插件并安装Ruby版本
  先更新Ruby插件到最新版本，保证能识别到完整的版本列表：
  asdf plugin update ruby
  后续可按需选择安装方式：
  1. 安装报错提示的指定3.0.2版本：
     RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl)" asdf install ruby 3.0.2
  2. 查看所有可安装的Ruby版本自行选择：
     asdf list all ruby
• 第四步：绑定生效版本
  安装完成后，配置全局生效的Ruby版本，解决初始的无预设版本报错：
  asdf global ruby 3.0.2
  如果仅需要当前项目使用该版本，将上述命令中的global替换为local即可，会自动在项目目录生成.tool-versions配置文件匹配需求。
• 第五步：验证生效
  执行命令验证Ruby版本是否正确识别：
  ruby -v
  如果执行rails命令仍然报错，执行重建软链接命令即可：
  asdf reshim ruby

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