SimpleCov为何在Ruby gem测试执行前生成覆盖率报告？

1. 修复.simplecov的大小写错误 #

你遇到的uninitialized constant Simplecov报错是拼写问题——SimpleCov的正确写法是大写C。修改根目录的.simplecov文件，确保使用正确的常量名：

# .simplecov
SimpleCov.start do
  # 可添加自定义配置，比如排除测试目录
  add_filter "/test/"
  add_group "核心代码", "lib"
end

2. 调整SimpleCov的加载时机（核心修复） #

bundle gem生成的gemspec默认会通过require_relative "lib/gemname/version"提前加载版本文件，这会导致Ruby在SimpleCov启动前就加载了部分lib代码，进而触发覆盖率报告提前生成。

修改gemspec的版本获取方式

把gemspec里的静态require改成动态读取版本号，避免提前加载lib文件：

# gemname.gemspec
# 替换原来的 require_relative "lib/gemname/version"
spec.version = File.read(File.join(__dir__, "lib", "gemname", "version.rb"))
                  .match(/VERSION = "(.*)"/)[1]

确保SimpleCov优先加载

修改test/test_helper.rb，把SimpleCov的加载和启动放在最顶部，早于所有其他依赖的加载：

# test/test_helper.rb
# 第一行就初始化SimpleCov
require 'simplecov'
SimpleCov.start

# 之后再加载测试框架和你的gem
require 'minitest/autorun'
require 'gemname'

3. 明确Rake任务执行顺序 #

默认的rake任务可能同时触发测试和Rubocop，导致执行逻辑混乱。可以在Rakefile里指定任务顺序，让测试先执行，再生成覆盖率报告：

# Rakefile
require 'bundler/gem_tasks'
require 'minitest/rake_task'

Minitest::RakeTask.new(:test) do |t|
  t.libs << 'test'
  t.libs << 'lib'
  t.test_files = FileList['test/**/*_test.rb']
end

# 默认任务先跑测试，再执行Rubocop
task default: [:test, :rubocop]

4. 验证修复效果 #

运行bundle exec rake test，会看到测试先执行完成，之后才生成覆盖率报告：

Run options: --seed 12345

# Running:

..

Finished in 0.001s, 2000 runs/s, 2000 assertions/s.

2 runs, 2 assertions, 0 failures, 0 errors, 0 skips
Coverage report generated for Minitest to /workspaces/gemname/coverage.
Line Coverage: 100.0% (12 / 12)

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