pytest单独测试单模块与全量测试时matreader.py覆盖率不一致问题

• 首先核实统计项属性：贴出的运行日志中括号内的百分比为全量测试用例执行进度，并非matreader.py的代码覆盖率。单独运行matreader_test.py时9条测试用例全部执行完成，进度显示为100%；全量运行32条测试用例时，执行完matreader_test.py的9条用例刚好完成总测试量的一半，因此进度显示为50%。若项目未安装pytest-cov插件，pytest本身不会输出代码覆盖率数值，大概率是误将执行进度判定为覆盖率。
• 若已安装pytest-cov且确认是覆盖率统计结果异常，常见原因如下：
  • 模块导入时机导致统计漏算：全量测试时，其余测试模块在覆盖率统计启动前就提前导入了matreader.py，该阶段执行的代码（顶层逻辑、装饰器、类定义等）不会被纳入覆盖率统计，导致结果偏低。
  • 测试间状态污染：其余测试模块修改了全局变量、单例对象的状态（如日志中出现的libmanager默认库配置），会改变matreader.py的分支执行路径，导致单独测试时覆盖的分支在全量测试时未被触发。
  • 覆盖率统计范围配置错误：未在pytest配置中明确指定统计的源码目录，全量测试时覆盖率统计会将测试文件、第三方依赖纳入计算，或漏算matreader.py的部分路径。

• 安装pytest-cov插件获取合规覆盖率统计：运行pip install pytest-cov完成安装后，执行测试时添加覆盖率参数即可输出代码覆盖率。
• 明确指定覆盖率统计范围，避免导入时机导致的统计误差：执行测试时使用如下命令：

  pytest --cov=../lib/ --cov-report=term
  

  也可在测试目录下的pytest.ini中添加固定配置：

  [pytest]
  addopts = --cov=Code/ --cov-report=term --cov-report=html
  cov_source = Code/
  

• 增加测试用例的状态隔离：在每个测试类/用例的setup、teardown阶段重置全局配置、单例对象的状态，避免不同测试模块之间的状态互相影响。
• 生成HTML格式的覆盖率报告定位问题：运行带--cov-report=html参数的测试命令后，打开生成的htmlcov目录下的matreader.py.html，红色标注的即为未覆盖的代码行，可直接定位是统计异常还是真的存在未覆盖的逻辑。

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