subprocess调用场景下pycov无法正确生成Tool.py覆盖率报告

覆盖率统计失效的核心原因很明确：pytest-cov 默认仅追踪 pytest 主进程内加载执行的Python代码，你通过subprocess模块拉起的Tool.py运行在完全独立的子进程中，没有加载覆盖率采集探针，执行轨迹不会被记录，自然会出现「代码实际已执行但报告显示未覆盖」的现象。

方案1：子进程注入覆盖率探针（改动最小，推荐） #

不需要调整现有业务逻辑，仅需修改三处配置即可：

• 调整Helper中subprocess启动Tool.py的逻辑，不要裸跑脚本，用coverage模块包裹启动命令，确保子进程也加载采集探针：
  假设你原来的启动命令类似["python", "Tool.py", arg1, arg2]，替换为如下写法：

  import sys
  # 复用当前pytest所在的解释器，避免环境不一致问题
  cmd = [
      sys.executable, "-m", "coverage", "run",
      "--parallel-mode",
      "--rcfile=.coveragerc",
      "Tool.py",
      arg1, arg2 # 原有传给Tool.py的参数全部原样保留
  ]
  # 后续subprocess调用逻辑不变，比如subprocess.run(cmd, capture_output=True)
  

• 修改.coveragerc配置，新增并行采集开关，支持多进程覆盖率数据分片存储：

  [run]
  branch = True
  dynamic_context = test_function
  include = Tool.py
  parallel = True  # 新增该行
  

• 调整批量跑测脚本，所有测试执行完成后统一合并分片数据、生成报告，避免单测循环中重复生成无效报告：

  import pytest
  from coverage import Coverage
  
  # 启动前清空历史覆盖率缓存，避免脏数据干扰
  cov = Coverage(config_file=".coveragerc")
  cov.erase()
  
  test_files = []
  for i in file_list:
      if i.startswith("test_"):
          test_files.append(i)
  
  for file in test_files:
      result_file_name = file.split(".")[0] + ".xml"
      pytest.main([
          file,
          "-o", "junit_logging=system-out",
          "--disable-pytest-warnings",
          f"--junitxml={result_folder}{result_file_name}",
          "--tb=line",
          "--cov",
          "--cov-config=.coveragerc",
          "--cov-report=",  # 跑测阶段不生成报告，最后统一输出
          "--cov-append",
          "-p", "no:cacheprovider"
      ])
  
  # 合并主进程+所有subprocess子进程的覆盖率分片数据
  cov.combine()
  # 生成最终html覆盖率报告
  cov.html_report(directory="htmlcov")
  

注意：确保当前运行pytest的Python环境已经安装coverage、pytest-cov依赖，避免子进程启动时报模块不存在的错误。

方案2：主进程直接导入调用Tool.py逻辑（无额外依赖） #

如果Tool.py不需要强依赖独立进程的隔离环境（比如独立环境变量、独立工作目录、避免全局变量污染等），可以直接去掉subprocess调用逻辑，在Helper中直接导入Tool.py的入口函数传参调用。这样Tool.py的代码全程在pytest主进程内执行，不需要额外配置即可被正常统计覆盖率。

注意：如果Tool.py的执行逻辑全部写在if __name__ == "__main__":代码块下，需要先把核心执行逻辑抽成可被外部导入的普通函数，否则导入时不会触发对应逻辑执行。

如果配置完还是存在统计异常，优先检查两项：

• 跑测时的工作目录必须和.coveragerc、Tool.py的存放目录一致，避免子进程读不到配置、匹配不到源码路径
• 每次跑测前手动清理项目根目录下所有.coverage开头的缓存文件，避免历史分片数据干扰合并结果

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