Ruby引入codebreaker gem报cannot load such file问题咨询

bundle info codebreaker能正常返回gem信息，仅代表Bundler已经成功拉取了你指定Git分支的源码包，不代表gem已经被正确加入Ruby的加载路径，这类LoadError的常见诱因有三个：

• 直接执行Ruby脚本时没有加载Bundler上下文，Ruby默认的全局加载路径（$LOAD_PATH）不会自动包含Git源安装的gem路径，自然找不到对应文件
• 你引用的development分支属于开发中版本，gem本身的gemspec配置存在缺陷：要么没有正确声明主入口文件，要么主入口的命名、路径和你require传入的参数不匹配
• 本地gem缓存损坏，Git源的gem不会像RubyGems官方源的包一样自动注册全局加载路径，索引损坏后脱离Bundler环境就无法被识别

按照优先级逐步排查操作即可：

1. 优先确认脚本运行在Bundler管理的依赖上下文中
   这是这类问题最高频的触发原因，两种修复方式选一个就行：
   • 在你写的test.rb最顶部，所有业务代码之前先加一行加载Bundler配置的代码：

     require 'bundler/setup'
     # 之后再写原来的引入逻辑
     require 'codebreaker'
     

   • 执行脚本时加bundle exec前缀，强制使用Bundler管理的依赖环境运行：

     bundle exec ruby test.rb
     

   这步操作会让Bundler提前把Gemfile里所有依赖的库路径注入到Ruby的加载路径中，不需要手动做路径配置。
2. 如果第一步操作后仍然报错，检查gem本身的文件结构
   执行bundle show codebreaker拿到这个gem在本地的存储路径，进入目录检查两个点：
   • 根目录下的.gemspec文件中是否正确配置了加载路径和文件列表，需要包含如下配置：

     spec.require_paths = ["lib"]
     spec.files = Dir["lib/**/*.rb"]
     

   • 检查lib目录下是否直接存在codebreaker.rb这个主入口文件，很多开发分支会把代码拆分到lib/codebreaker/子目录下，但漏写最外层的主入口文件。如果确实没有外层入口，就按照实际文件路径引入，比如对应存在的文件写require 'codebreaker/main'即可。
3. 以上配置都正常的话，清理缓存重装依赖
   执行如下命令删除本地损坏的缓存包，重新拉取构建索引：

   bundle exec gem uninstall codebreaker
   bundle install --force
   

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