WSL 2 Ubuntu执行gem install时提示无法加载zlib文件求助

错误分析 #

你遇到的cannot load such file -- zlib错误，说明当前Ruby环境没正确关联zlib库。虽然已经装了系统级的zlib1g-dev，但如果Ruby是通过rbenv、rvm这类版本管理器安装的，系统依赖不会自动关联到Ruby环境，得手动重新编译Ruby来绑定zlib。

检查Ruby环境与路径 #

1. 确认Ruby安装方式
   运行以下命令查看当前Ruby的安装路径：

   which ruby
   

   • 输出为/usr/bin/ruby：属于系统自带Ruby
   • 输出包含~/.rbenv/或~/.rvm/：是用版本管理器安装的Ruby

2. 验证zlib是否被Ruby识别
   运行以下命令测试zlib支持：

   ruby -r zlib -e "puts 'zlib is working'"
   

   若报错，说明Ruby未关联zlib库，需要修复。

针对性修复方案 #

情况1：系统自带Ruby #

直接安装Ruby的zlib扩展包：

sudo apt install ruby-zlib

安装完成后重新尝试：

gem install bundler:1.9.0

情况2：rbenv安装的Ruby #

重新编译Ruby并指定zlib路径：

# 确保zlib1g-dev已安装
sudo apt install zlib1g-dev
# 重新编译当前使用的Ruby版本
CONFIGURE_OPTS="--with-zlib-dir=/usr/include" rbenv install $(rbenv version-name)
# 重新安装bundler
gem install bundler:1.9.0

情况3：rvm安装的Ruby #

安装rvm的zlib包并重新编译Ruby：

# 安装rvm的zlib依赖
rvm pkg install zlib
# 重新安装当前Ruby版本并绑定zlib
rvm reinstall $(rvm current) --with-zlib-dir=$HOME/.rvm/usr
# 重新安装bundler
gem install bundler:1.9.0

检查gem路径匹配 #

运行gem env查看gem的配置信息，重点确认：

• RUBY EXECUTABLE：是否和当前使用的Ruby路径一致
• INSTALLATION DIRECTORY：是否为当前Ruby版本对应的gem目录

如果路径不匹配，切换到正确的Ruby版本：

• rbenv：rbenv local <你的Ruby版本号>
• rvm：rvm use <你的Ruby版本号>

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