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

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

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"]，后者无效

覆盖率数字高但实际质量差？关键看 branch 覆盖和部分行覆盖细节

行覆盖（line coverage）到 95% 很容易骗人：一个 if x and y: 只测了 True and True，False 分支完全没走，但行数仍算“覆盖”。这时候 --cov-branch 就暴露问题了。

• 加 --cov-branch 后，报告里会出现 Branch 列，数值通常比 Line 低一截，这才是真实逻辑密度
• HTML 报告中黄色高亮行表示“部分覆盖”：比如 if a or b: 只触发了 a=True，b 永远没参与判断，这一行就算“部分”
• 别迷信整体百分比，打开 htmlcov/index.html 点进具体文件，重点看标红（未执行）和标黄（部分）的逻辑块，尤其是异常路径、边界条件

覆盖率工具不自动理解业务意图，它只忠实地反馈“哪些代码被 CPU 执行过”。同一行写十个表达式，只要有一个没走，就标黄；一个函数被调用一百次，只要有一条分支永远不进，它就不是真覆盖。盯住 HTML 报告里的颜色和分支数，比盯着总分重要得多。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。