pytest-cov 显示 0% 覆盖率的根本原因是路径不匹配，需用 --cov=. 确认源码根路径，再按实际结构（如 src/myapp）精确指定，并确保 pythonpath 正确或避免导入路径混乱。
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 报告里的颜色和分支数，比盯着总分重要得多。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
