在rails/rails仓库运行bundle时RubyGems插件加载失败求助

问题分析 #

错误提示显示系统尝试加载yard的RubyGems插件时，找不到对应的rubygems_plugin.rb文件，核心原因是指定版本的yard gem未正确安装到当前asdf管理的Ruby 3.3.0环境中，或者插件目录存在无效的链接文件。

解决步骤 #

• 重新安装指定版本的yard gem
  在终端执行命令，确保缺失的文件被补上：

  gem install yard -v 0.9.34
  

• 删除无效的插件链接
  如果重新安装后仍报错，直接移除插件目录里的无效文件：

  rm /Users/dorianmariefr/.asdf/installs/ruby/3.3.0/lib/ruby/gems/3.3.0/plugins/yard_plugin.rb
  

  再次执行上一步的gem安装命令，会自动生成正确的插件文件。

• 刷新gem缓存与生成可执行文件
  执行以下命令重置gem相关缓存与链接：

  gem cleanup
  gem regenerate_binstubs
  

• 重置Ruby环境
  通过asdf切换到其他Ruby版本再切回，触发环境重新加载：

  asdf global ruby <其他已安装的Ruby版本号>
  asdf global ruby 3.3.0
  

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