React Native项目执行pod install遇bundler缺失错误求助

执行cd ios && pod install时触发以下错误：

/Library/Ruby/Site/2.6.0/rubygems.rb:264:in `find_spec_for_exe': can't find gem bundler (>= 0.a) with executable bundle (Gem::GemNotFoundException)
    from /Library/Ruby/Site/2.6.0/rubygems.rb:283:in `activate_bin_path'
    from /usr/bin/bundle:23:in `<main>'

已执行的排查操作及终端输出：

• 查看Ruby版本：

  ruby -v
  

  输出：

  ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin22]
  

• 更新gem系统：

  gem update --system
  

  输出：

  Latest version already installed.
  

• 查看PATH环境变量：

  echo $PATH
  

  输出：

  /opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/opt/homebrew/bin:/opt/homebrew/sbin:/Users/dinar/.rvm/bin
  

解决方案 #

1. 安装兼容的bundler版本 #

Ruby 2.6.x不支持bundler 2.4及以上版本，执行以下命令安装兼容版本：

gem install bundler -v 2.3.26

安装完成后，回到iOS目录重新执行pod install。

2. 解决RVM与系统Ruby的环境冲突 #

从PATH可以看到同时存在RVM和系统Ruby路径，可能导致环境混乱。尝试切换到RVM管理的Ruby版本：

# 列出已安装的Ruby版本
rvm list
# 切换到某个较新版本（如3.0.x，若未安装先执行rvm install 3.0.0）
rvm use 3.0.0
# 安装bundler
gem install bundler

之后再执行cd ios && pod install。

3. 清理gem缓存并重新安装 #

gem clean bundler
gem install bundler -v 2.3.26

4. 调整PATH优先级确保使用RVM的bundle #

编辑你的shell配置文件（~/.zshrc或~/.bashrc），将RVM的bin目录移到PATH最前面：

export PATH="$HOME/.rvm/bin:$PATH"

保存后执行source ~/.zshrc（或对应shell的配置文件），重启终端后重新尝试pod install。

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