构建Flutter iOS项目时遭遇gems executable-hook未找到错误

执行flutter run构建Flutter iOS项目时，CocoaPods输出以下错误：

Error output from CocoaPods:
           ↳
[        ]     Ignoring executable-hooks-1.6.1 because its extensions are not built. Try: gem pristine executable-hooks --version 1.6.1
               Ignoring executable-hooks-1.6.1 because its extensions are not built. Try: gem pristine executable-hooks --version 1.6.1

按照提示执行gem pristine executable-hooks --version 1.6.1后，仍出现加载错误：

Ignoring executable-hooks-1.6.1 because its extensions are not built. Try: gem pristine executable-hooks --version 1.6.1
Error loading RubyGems plugin "/Users/[user_name]/.rvm/rubies/ruby-3.1.2/lib/ruby/gems/3.1.0/plugins/executable-hooks_plugin.rb": cannot load such file -- executable-hooks/wrapper (LoadError)

解决方案 #

• 卸载有问题的executable-hooks版本：

  gem uninstall executable-hooks --version 1.6.1
  

• 重新安装该版本gem，确保扩展正确构建：

  gem install executable-hooks --version 1.6.1
  

• 如果上述步骤无效，检查Ruby版本兼容性：
  Ruby 3.1.x与部分旧gem存在兼容性问题，可切换到更稳定的2.7.x版本（以rvm为例）：

  rvm install 2.7.6 && rvm use 2.7.6
  

• 最后重新初始化CocoaPods：
  进入项目的iOS目录，执行：

  pod deintegrate && pod install
  

问题原因 #

该错误源于executable-hooks gem的编译扩展与当前Ruby版本不兼容，或gem安装过程中扩展构建不完整。卸载重装可修复扩展缺失问题，切换Ruby版本则能从根源解决版本适配冲突。

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