Ruby 2.5.3环境下安装兼容Bundler版本失败求助

1. 锁死当前终端的Ruby环境 #

先在项目目录下用asdf切换到指定版本，避免全局版本干扰：

asdf local ruby 2.5.3
ruby -v

必须输出ruby 2.5.3p105，如果不对，重启终端或者执行asdf reshim ruby刷新可执行文件映射。

2. 清理冲突Bundler，安装兼容版本 #

Bundler 2.4.x系列要求Ruby≥2.6.0，和你的2.5.3不兼容，需安装2.3.x中明确支持Ruby 2.5的稳定版本：

• 先彻底清理所有已安装的Bundler：

gem uninstall bundler --all --executables

• 安装2.3.26（该版本对Ruby 2.5的兼容性更稳定）：

gem install bundler -v 2.3.26

• 验证安装结果：

bundle -v

如果仍提示找不到bundler，执行asdf reshim ruby刷新asdf的可执行文件路径映射。

3. 正确执行bundle install #

在项目目录下，确认Ruby版本无误后，用指定版本的Bundler执行安装：

bundle _2.3.26_ install

若还是报找不到bundler，直接调用gem可执行文件的完整路径：

$(gem environment gemdir)/bin/bundle _2.3.26_ install

4. 解决rubygems API报错 #

如果安装Bundler时遇到API相关错误，切换到国内rubygems镜像：

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem sources -l

确认仅保留国内镜像源后，重新安装Bundler即可。

5. 避免全局版本冲突 #

不要将Ruby 2.5.3设为全局版本，在项目根目录创建.tool-versions文件，内容如下：

ruby 2.5.3

后续进入该目录时，asdf会自动切换到对应版本，避免与其他项目的Ruby版本冲突。

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