`coverage run -m pytest`与`pytest --cov=...`的功能差异解析

二者不只是选项/配置选择的不同，存在不少实际功能区别，核心差异如下：

• 启动逻辑与进程监控范围

  • coverage run -m pytest是先启动Coverage工具，再由它拉起Pytest进程，Coverage会监控整个Pytest运行期间的所有代码，但对于Pytest自身启动的一些辅助子进程（比如某些插件的后台进程），可能无法精准捕获覆盖数据。
  • Pytest-Cov作为Pytest插件，会在Pytest初始化阶段就启动Coverage，完全嵌入Pytest的测试生命周期，能精准跟踪测试用例执行时的代码覆盖，不会遗漏Pytest子进程的覆盖数据。

• 测试用例与覆盖数据的关联能力

  • Pytest-Cov支持将覆盖率数据和具体测试用例绑定，能生成包含每个测试用例对应覆盖情况的报告，甚至在终端输出时就能看到单条用例的覆盖细节。
  • 直接用coverage run只能生成整体的项目覆盖率统计，无法关联到单个测试用例，没法直观知道哪条用例覆盖了哪些代码。

• 配置集成性

  • Pytest-Cov可以直接复用Pytest配置文件（如pytest.ini、pyproject.toml）中的Coverage相关配置，不用单独维护coverage.ini，配置更统一。
  • coverage run只能读取自身的配置文件，和Pytest配置完全分离，需要单独管理两套配置。

• 多进程/分布式测试适配

  • 如果用pytest-xdist做分布式或并行测试，coverage run无法自动合并多个子进程的覆盖数据，需要手动执行coverage combine等命令，还容易出现数据丢失。
  • Pytest-Cov专门针对这类场景做了适配，能自动收集并合并所有子进程的覆盖率结果，无需额外操作。

• 后续流程简化

  • Pytest-Cov在测试结束后会自动处理Coverage的临时数据，和Pytest的清理流程同步，直接就能生成最终报告。
  • coverage run需要手动执行coverage report或coverage html来生成报告，如果有多数据源还要先执行合并命令，步骤更繁琐。

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