Ventura系统Ruby3.1.3环境中Bundler安装成功却无法识别的问题

云上老周

2026-7-12

解决Bundler版本不匹配问题的步骤

核心问题

你安装的Bundler 2.3.26是在Ruby 3.1.3环境下，但系统默认调用的是Mac自带的Ruby 2.6，导致找不到对应版本的Bundler。

确认当前Ruby版本
运行命令：
```
ruby -v
```
如果输出是ruby 2.6.x，说明当前环境是系统自带Ruby，需要切换到Ruby 3.1.3。
切换到Ruby 3.1.3环境
- 若用rbenv管理Ruby版本：
```
# 当前项目目录生效
rbenv local 3.1.3
# 或全局生效
rbenv global 3.1.3
```
- 若用rvm管理Ruby版本：
```
rvm use 3.1.3
```
- 若直接安装Ruby 3.1.3，需确保其bin目录在PATH最前面：
  编辑~/.zshrc文件，添加：
```
export PATH="/usr/local/bin:$PATH"
```
  生效配置：
```
source ~/.zshrc
```
再次运行ruby -v确认版本为3.1.3。
重新安装指定版本的Bundler
先卸载残留的错误版本：
```
gem uninstall bundler -v 2.3.26
```
重新安装（不要加--default参数）：
```
gem install bundler:2.3.26
```
验证并执行bundle install
确认Bundler版本：
```
bundler -v
```
输出应为Bundler version 2.3.26，此时执行：
```
bundle install
```
即可正常运行。