WSL2环境使用rbenv安装Ruby 3.0.1，已装OpenSSL/LibYAML依赖仍报扩展编译失败

这类报错并非系统未安装libssl-dev、libyaml-dev依赖，本质是三类常见问题导致编译中断：

• 本地安装的ruby-build版本滞后，对Ubuntu 20.04环境下的库路径识别存在bug
• 之前失败的安装流程残留了临时编译缓存，污染新的编译环境
• 编译依赖安装不全，仅安装日志提示的两个包遗漏了其余编译必需的系统库

• 升级本地ruby-build组件到最新版本
  当前使用的20210423版本的ruby-build对Ubuntu 20.04的库路径适配存在已知问题，直接在插件目录拉取最新代码即可：
  cd ~/.rbenv/plugins/ruby-build && git pull
  如果是通过apt源安装的ruby-build，建议先卸载源安装版本，换成git方式部署的版本，避免软件源滞后导致版本过旧。
• 彻底清理旧的失败构建残留
  之前编译失败的临时文件、未完成的版本目录会缓存旧的编译配置，直接清除所有相关残留：
  rm -rf /tmp/ruby-build.* ~/.rbenv/versions/3.0.1
• 安装完整的Ruby编译依赖集
  注意：日志仅会提示最先触发编译失败的扩展依赖，不代表其余依赖不存在缺失。Ubuntu 20.04下编译Ruby 3.0.1需要的完整依赖列表执行安装即可：
  sudo apt-get install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm-dev
• 显式指定pkg-config路径重新执行安装
  WSL环境下偶尔会出现pkg-config路径识别偏差，导致编译器找不到已安装的libyaml位置，执行安装时带上环境变量即可规避：
  PKG_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig rbenv install 3.0.1

• 所有rbenv安装相关操作必须在WSL本地Linux文件系统路径（如/home/用户名目录）下执行，跨Windows挂载路径的权限、路径映射问题会直接导致编译时无法识别系统库位置
• 安装完成后可以执行rbenv versions确认版本安装成功，再执行rbenv global 3.0.1设置全局默认版本
• 如果执行安装后仍提示yaml扩展编译失败，可先通过dpkg -L libyaml-dev | grep yaml.h确认libyaml的头文件存在于系统默认头文件搜索路径下，排除库安装路径异常的问题

内容的提问来源于stack exchange，提问作者adam.smith