当前位置：首页 > 文章列表 > 文章 > python教程 > Python代码覆盖率怎么查看？pytest-cov生成详细报告

Python代码覆盖率怎么查看？pytest-cov生成详细报告

2026-04-05 13:09:29 0浏览收藏

Python代码覆盖率报告常显示0%或失真，并非代码未执行，而是路径配置错误、源码根目录未正确指定（如项目在src/下却未用--cov=src/myapp）、PYTHONPATH混乱或导入结构不当所致；htmlcov中“No data to report”往往因文件仅被导入未执行、含TYPE_CHECKING跳过块、缺失--cov-branch参数导致分支未统计，或文件编码含BOM引发静默解析失败；要获得真实业务质量反馈，必须通过pyproject.toml精准配置source白名单与omit过滤规则排除测试和依赖，并强制启用--cov-branch查看分支覆盖——因为高行覆盖率极易掩盖关键逻辑漏洞，真正可信的指标藏在HTML报告里标红（未执行）和标黄（部分覆盖）的细节中，而非总分。

Python代码覆盖率怎么看_结合pytest-cov生成详细统计报告

pytest-cov 生成的覆盖率报告为什么总是显示 0%？

常见现象是跑完 pytest --cov=myapp，终端输出里 coverage 行全是 0%，但代码明明执行了。根本原因通常是路径没对上——pytest-cov 默认按当前工作目录下的包结构找源码，而你的模块可能在 src/ 下、或安装为可编辑模式但未被识别。

确认源码根路径：用 --cov=. 代替 --cov=myapp，先看是否覆盖到任意文件；再逐步缩小范围
如果项目结构是 src/myapp/，必须显式写 --cov=src/myapp，且确保 src/ 在 PYTHONPATH 或已通过 -m pytest 正确加载
避免用 python -m pytest 启动却把测试放在 tests/ 外层，导致导入路径混乱，coverage 扫不到实际执行的源文件

htmlcov 报告里某些文件显示 “No data to report”

这不代表没运行，而是 coverage.py 根本没收集到这些文件的执行痕迹。典型场景是：文件被 import 了，但里面只有定义、没被调用；或者用了 if TYPE_CHECKING: 这类运行时跳过的分支。

检查是否漏加 --cov-branch：条件语句和循环体没被标记为“已覆盖”，默认只统计行覆盖，分支逻辑会直接消失
确认文件编码是 UTF-8 且无 BOM，带 BOM 的 Python 文件可能导致 coverage 解析失败，静默跳过
如果文件在 __init__.py 中被导入但没执行任何语句，它不会出现在报告中——coverage 只记录执行过的行，不记录声明

如何让 pytest-cov 只统计业务代码，排除测试和第三方依赖？

默认 --cov 会把所有导入都拉进来，包括 tests/ 目录和 venv/ 里的包，结果失真。必须靠配置过滤。

在 pyproject.toml 中加：

[tool.coverage.run]
source = ["myapp"]
omit = ["*/tests/*", "*/test_*.py", "*/venv/*", "*/env/*"]

不要依赖 --cov-report=term-missing 来“看出哪些没覆盖”，它只是补全提示，真正过滤得靠 omit 或 source
source 是白名单，优先级高于 omit；如果两者冲突，以 source 为准——比如 source=["myapp"] + omit=["myapp/utils.py"]，后者无效