开发本地Ruby Gem时运行Rake任务遇cannot load such file错误求助

看起来你遇到的核心问题是本地Gem的gemspec配置不完整，导致Bundler虽能识别Gem位置，但Ruby无法找到对应库文件。下面一步步帮你排查解决：

1. 完善valet-tasks的gemspec文件 #

你没有提供valet-tasks.gemspec的内容，但这是本地Gem能否被正确加载的关键。这个文件需要明确声明Gem的加载路径和包含的文件，创建或修改你的valet-tasks.gemspec为如下内容：

# frozen_string_literal: true

require_relative "lib/valet-tasks/version"

Gem::Specification.new do |spec|
  spec.name          = "valet-tasks"
  spec.version       = ValetTasks::VERSION
  spec.authors       = ["Your Name"]
  spec.email         = ["your@email.com"]

  spec.summary       = "Custom rake tasks for your project"
  spec.description   = "A local gem to share rake tasks across projects"
  spec.homepage      = "" # 可填写你的仓库地址或留空
  spec.license       = "MIT"
  spec.required_ruby_version = ">= 2.7.0"

  # 自动包含Git追踪的所有非测试文件（推荐）
  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
  end
  spec.bindir        = "exe"
  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
  # 关键：告诉Ruby去lib目录找Gem代码
  spec.require_paths = ["lib"]

  # 声明Gem依赖
  spec.add_dependency "rake", "~> 13.0"
end

重点说明：

• spec.require_paths = ["lib"]：这行必须存在，它指定Ruby加载Gem代码的根目录。
• spec.files：确保包含lib下的所有.rb文件，否则Bundler不会把这些文件加入到Ruby的加载路径中。

2. 修改主项目的Rakefile，通过Bundler加载依赖 #

主项目的Rakefile需要先初始化Bundler，这样才能正确加载Gemfile中指定的本地Gem。修改你的Rakefile：

# frozen_string_literal: true
require 'bundler/setup' # 先让Bundler处理Gem依赖
require 'valet-tasks'

3. 使用bundle exec运行Rake命令 #

直接运行rake不会让Bundler介入，必须用bundle exec来确保加载路径包含你的本地Gem：

bundle exec rake -T --trace

额外检查点 #

• 确认Gemfile中的路径正确：../../Gems/valet-tasks是相对于主项目根目录的路径，你可以用cd ../../Gems/valet-tasks在主项目根目录下测试是否能进入该目录。
• 验证本地Gem的加载：在主项目中运行bundle exec irb，然后执行require 'valet-tasks'，如果成功加载说明配置没问题；如果失败，运行$LOAD_PATH.each { |p| puts p }检查是否包含本地Gem的lib目录。

按照这些步骤调整后，你的本地Gem应该能被正确加载，Rake任务也会正常显示。

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