Ruby Minitest未检测到生产代码缺失require的原因及改进方案

为什么单元测试没有出现NameError错误？ #

测试代码的setup方法中调用了Pathname.new，触发了Ruby的自动加载机制：当Ruby遇到未定义的常量时，会尝试加载与常量名称匹配的标准库文件（这里就是pathname.rb）。等生产代码后续执行时，Pathname常量已经被测试代码加载完成，因此不会触发uninitialized constant错误。

而主脚本直接调用生产代码时，没有任何代码提前加载pathname库，且生产代码本身未添加require 'pathname'，所以运行时找不到Pathname常量，抛出NameError。

如何重构测试，确保只有生产代码包含正确的require语句时测试才能通过？ #

核心思路是避免测试代码提前加载Pathname，让生产代码必须自行负责依赖加载，以下是几种可行方案：

方案1：改用字符串断言，移除测试对Pathname的依赖 #

修改测试代码，直接用字符串对比结果，不依赖Pathname类，这样测试环境中不会提前加载pathname库：

require 'minitest/autorun'
require 'minitest/color'

# 仅加载生产代码，不提前引入Pathname
require_relative '../lib/util/input_file'

class TestInputFile < Minitest::Test
  def test_default_input_file
    input_file = Util::InputFile.new(1)
    # 直接用字符串断言路径
    assert_equal("/path/to/inputs/input01.txt", input_file.abspath.to_s)
  end

  # 其他测试用例保持不变
end

此时如果生产代码未添加require 'pathname'，测试运行时会直接抛出NameError，和主脚本的表现一致。

方案2：添加专门的依赖验证测试 #

新增测试用例，在隔离环境中验证生产代码是否自行加载了Pathname：

require 'minitest/autorun'
require 'minitest/color'

require_relative '../lib/util/input_file'

class TestInputFile < Minitest::Test
  def test_default_input_file
    @input_path = Pathname.new("/path/to/inputs")
    input_file = Util::InputFile.new(1)
    expected_path = @input_path.join('input01.txt')
    assert_equal(expected_path, input_file.abspath)
  end

  # 验证生产代码自行加载Pathname依赖
  def test_production_code_loads_pathname
    # 卸载已加载的Pathname常量（仅用于测试隔离）
    Object.send(:remove_const, :Pathname) if defined?(Pathname)
    # 重新加载生产代码
    load '../lib/util/input_file.rb'
    # 触发生产代码逻辑，若未加载Pathname则会报错
    assert_nothing_raised(NameError) { Util::InputFile.new(1).abspath }
  end
end

这个测试会先清除已有的Pathname常量，再重新加载生产代码，确保生产代码必须自行加载pathname库才能通过测试。

方案3：用子进程隔离测试环境 #

通过创建子进程运行测试逻辑，确保子进程中只有生产代码的依赖被加载，完全模拟主脚本的运行环境：

require 'minitest/autorun'
require 'minitest/color'

class TestInputFile < Minitest::Test
  def test_default_input_file_in_isolated_env
    pid = fork do
      # 子进程中仅加载生产代码
      require_relative '../lib/util/input_file'
      input_file = Util::InputFile.new(1)
      assert_equal("/path/to/inputs/input01.txt", input_file.abspath.to_s)
      exit! # 子进程正常退出
    end
    Process.wait(pid)
    # 验证子进程退出状态为0（无错误）
    assert_equal(0, $?.exitstatus, "生产代码未正确加载Pathname依赖")
  end
end

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