使用simplecov gem统计Ruby项目测试覆盖率异常及判定规则咨询

问题底层成因 #

Rails的Minitest并行测试采用fork多进程机制实现：主进程会先加载基础环境，再fork出多个worker子进程分配测试用例执行，所有测试逻辑的实际运行都在子进程中完成。
你原配置只在主进程启动了SimpleCov，fork出来的子进程不会继承覆盖率追踪能力，子进程产生的覆盖数据也不会自动汇总到主进程，最终主进程只能统计到自身加载阶段执行的代码，大部分业务代码的执行记录都丢失，就出现了测试全过但覆盖率统计异常的问题。

SimpleCov覆盖判定规则 #

SimpleCov基于Ruby内置的Coverage模块实现覆盖率统计，判定标准如下：

• 首先会自动过滤空行、纯注释行，剩下的标记为「相关代码行（relevant line）」，是覆盖率统计的分母
• 类/模块定义行、类级别的方法调用（如模型里的validates、scope等）、方法定义行、内部逻辑语句均属于相关行
• 只要某行代码在测试执行过程中被Ruby解释器执行过至少一次，就会被标记为已覆盖，否则为未覆盖（miss）
• 你遇到的0/0统计结果，是因为主进程未收集到任何相关代码的执行记录，所以分母、分子均为0

适配并行测试的配置方案 #

无需关闭并行测试，只需修改test_helper.rb的SimpleCov配置，开启多进程结果合并即可，修改后的配置如下：

require 'simplecov'
# 开启并行结果合并，设置合并超时时间（可根据测试总时长调整）
SimpleCov.start do
  enable_coverage :branch # 可选配置，开启分支覆盖率统计
  use_merging true
  merge_timeout 3600
end

ENV['RAILS_ENV'] ||= 'test'
require_relative "../config/environment"
require "rails/test_help"
require 'webmock/minitest'


class ActiveSupport::TestCase
  parallelize(workers: :number_of_processors)
  # 新增：每个worker进程启动时设置独立的命令名，避免覆盖数据冲突
  parallelize_setup do |worker|
    SimpleCov.command_name "minitest-worker-#{worker}"
  end
  # 新增：每个worker执行结束后生成覆盖结果，等待合并
  parallelize_teardown do |worker|
    SimpleCov.result
  end

  fixtures :all

  def log_in_as(user, shop)
    post user_session_url, params: { user_id: user.id, active_shop_id: @site.shop_id }
  end
end

配置修改完成后，先删除项目根目录下的coverage缓存文件夹，再重新执行测试即可正常统计覆盖率。如果配置不生效，可先将Gemfile中的simplecov升级到最新稳定版后重试。

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