pytest CLI与代码调用执行测试时覆盖率报告不一致问题排查

• 覆盖率工具初始化时机差异
  使用pytest CLI执行时，覆盖率工具（如coverage.py）会在测试启动前完成初始化，全程追踪模块从加载到执行的所有代码。但通过代码调用pytest时，若你在启动测试前就已经导入了被测模块（比如colours.py），这些提前执行的代码（import语句、类定义、方法定义、装饰器等）不会被覆盖率工具统计——因为工具是在模块加载完成后才开始追踪的，自然会把这些行标记为未覆盖。

• init.py的追踪范围配置不同
  CLI模式下，pytest会自动将项目根目录加入Python路径，覆盖率工具默认会追踪该路径下的所有模块文件，包括__init__.py。但代码调用pytest时，若没有显式通过代码配置覆盖率的source参数或路径范围，覆盖率工具可能无法识别根目录下的__init__.py，导致该文件被排除在报告之外。

• 代码调用未继承CLI的默认覆盖率配置
  用pytest CLI执行时，覆盖率工具会自动读取项目中的.coveragerc配置文件或使用默认规则，明确要追踪的模块、排除项等。而代码调用pytest时，若没有通过代码传递这些配置参数（比如在pytest.main()中指定--cov相关参数，或通过coverage模块的API配置），覆盖率的统计逻辑就会和CLI模式不一致，出现统计遗漏。

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