SimpleCov合并子项目覆盖率时非最后项目显示100%问题求助

我之前踩过这个一模一样的坑！你的问题核心是SimpleCov的全局状态没有在子项目测试之间正确重置，再加上子项目的root路径配置有误，才导致只有最后一个子项目的覆盖率显示正常，其余被误判为100%。下面是具体的解决步骤：

问题根源拆解 #

SimpleCov在启动时会初始化全局的覆盖率跟踪状态，如果不主动重置，每个子项目运行时会复用之前的状态：要么前面子项目的覆盖率数据被后续覆盖，要么因为子项目的源文件路径匹配错误，SimpleCov找不到未覆盖的文件，默认判定为100%覆盖。

具体修复方案 #

1. 每个子项目测试前强制重置SimpleCov状态 #

在Rakefile的每个子项目测试任务中，先调用SimpleCov.clear和SimpleCov.reset清空全局状态，再重新启动SimpleCov并指定子项目专属配置。示例代码：

task :test_plugin1 do
  # 为子项目设置专属标识和路径
  ENV['PLUGIN_NAME'] = 'plugin1'
  ENV['PLUGIN_ROOT'] = "#{ENV['WORKSPACE']}/plugin1"
  ENV['COVERAGE_DIR'] = "#{ENV['WORKSPACE']}/coverage"

  # 关键：重置全局状态，避免和其他子项目混淆
  SimpleCov.clear
  SimpleCov.reset

  # 启动SimpleCov，指定子项目的根目录和命令名
  SimpleCov.start do
    coverage_dir ENV['COVERAGE_DIR']
    command_name ENV['PLUGIN_NAME']
    root ENV['PLUGIN_ROOT'] # 必须指定子项目自己的根，不能用全局根！
  end

  # 运行子项目测试
  sh "cd #{ENV['PLUGIN_ROOT']} && bundle exec rspec"
end

# 同理复制test_plugin2、test_plugin3等任务

2. 确保子项目的SimpleCov配置正确 #

每个子项目的测试文件（比如/root/plugin1/tests/plugin/test.rb）里，必须明确指定子项目的root路径，不能依赖全局环境的默认值。示例配置：

SimpleCov.start do
  coverage_dir "#{ENV['WORKSPACE']}/coverage"
  command_name 'plugin1'
  root "#{ENV['WORKSPACE']}/plugin1" # 这里一定要精准指向子项目根目录
  # 其他自定义配置（如过滤、分组）保留即可
end

如果root设置错误，SimpleCov会找不到子项目的源文件，直接判定所有文件都被覆盖，导致显示100%。

3. 正确编写根目录的合并任务 #

根目录的合并任务要在所有子项目测试完成后执行，确保读取所有子项目的覆盖率数据。示例：

task :merge_coverage => [:test_plugin1, :test_plugin2, :test_plugin3] do
  SimpleCov.start do
    coverage_dir "#{ENV['WORKSPACE']}/coverage"
    root ENV['WORKSPACE'] # 这里用根项目的全局根目录
  end

  # 强制生成合并后的覆盖率报告
  SimpleCov.result.format!
end

⚠️ 注意：必须串行执行所有子项目测试任务，并行执行会导致coverage/.resultset.json被多进程同时写入，造成数据损坏。

4. 验证覆盖率数据文件 #

运行完所有子项目测试后，打开coverage/.resultset.json检查：

• 是否每个子项目的command_name都有对应的条目
• 每个条目里的files路径是否正确指向子项目的源文件
  如果某个子项目的files为空或路径错误，那就是导致它显示100%的直接原因。

额外小提示 #

• 可以在每个子项目测试任务结束后，打印覆盖率结果做验证：

  puts "#{ENV['PLUGIN_NAME']} coverage: #{SimpleCov.result.covered_percent}%"
  

• 不要在子项目之间共享SimpleCov的全局配置，每个子项目的配置要独立初始化。

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