Flutter运行iOS模拟器提示Ruby解释器或扩展库存在bug如何解决？
2026-9-30
Flutter iOS pod install Ruby错误解决方案
报错信息：
error running pod install. error launching iPhone 13
You may have encountered a bug in the Ruby interpreter or extension libraries.
该报错本质是Ruby环境和CocoaPods版本不兼容导致，和是否编写Ruby代码无关，按以下步骤操作即可解决：
步骤1：清理本地缓存与旧Pod文件
- 打开终端进入Flutter项目根目录，执行清理命令：
flutter clean - 进入项目ios子目录，删除旧Pod相关文件：
rm -rf Podfile.lock Pods Runner.xcworkspace - 全局清理CocoaPods缓存：
rm -rf ~/Library/Caches/CocoaPods rm -rf ~/.cocoapods/repos
步骤2：修复Ruby环境
macOS系统自带的Ruby版本老旧、权限限制多，经常出现兼容性问题，建议替换为rbenv管理的稳定版本：
- 用Homebrew安装rbenv与Ruby构建工具：
brew install rbenv ruby-build - 安装兼容性稳定的Ruby 3.2.2版本：
rbenv install 3.2.2 - 设置该版本为全局默认Ruby版本：
rbenv global 3.2.2 - 配置终端环境变量：
如果你使用zsh终端，执行：echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
如果你使用bash终端，执行：echo 'eval "$(rbenv init - bash)"' >> ~/.bash_profile - 重启终端后执行
ruby -v确认版本显示为3.2.2即可 - 重新安装CocoaPods：
gem install cocoapods
步骤3：重新安装依赖并启动项目
- 进入项目ios目录，执行Pod安装命令：
pod install --repo-update - 回到项目根目录启动项目：
flutter run
备选修复方案
如果上述操作后仍报错，检查Xcode命令行工具配置：
- 执行命令：
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer - 输入密码确认后重新执行
pod install操作即可
内容的提问来源于stack exchange，提问作者Ronak The Coder
相关产品推荐
相关产品推荐
