本文教你通过配置 coverage.py 工具，将测试覆盖率统计范围严格限定在自有代码目录内，从而真实反映项目质量，避免因第三方依赖（如 sortedcontainers）拉低整体覆盖率数值。
本文教你通过配置 coverage.py 工具，将测试覆盖率统计范围严格限定在自有代码目录内，从而真实反映项目质量，避免因第三方依赖（如 sortedcontainers）拉低整体覆盖率数值。
在 Python 项目中，使用 coverage.py 生成覆盖率报告时，默认会扫描整个执行过程中加载的所有模块——包括你项目中的源码、测试文件，甚至系统级或第三方安装的包（例如 /usr/lib/python3/dist-packages/sortedcontainers/）。正如你的报告所示：虽然 calculator.py（87%）、results.py（87%）、test_statistics.py（99%）等自有模块已具备良好覆盖，但 sortedlist.py、sorteddict.py 等第三方库文件因未被主动测试，大幅拉低了整体覆盖率（仅 33%），这既无实际意义，也误导评估。
正确做法是：明确指定覆盖率分析的源码根目录。
只需在运行 coverage 命令时添加 --source=. 参数（. 表示当前项目根目录），即可强制工具只统计当前工作目录下（递归）的 Python 文件：
# 推荐：指定源码路径，聚焦自有代码 coverage run -m pytest tests/ coverage report --source=. # 或结合 HTML 报告，便于可视化审查 coverage html --source=.
你也可以将该配置持久化到项目根目录下的 .coveragerc 文件中，避免每次重复输入：
# .coveragerc
[run]
source = .
omit = */tests/*, */__pycache__/*, */venv/*, */env/*
[report]
exclude_lines =
pragma: no cover
def __repr__
raise AssertionError
raise NotImplementedError✅ 关键优势：
- 覆盖率数值真实反映你编写的业务逻辑质量；
- Total 行将仅汇总 calculator.py、results.py、program.py 等自有文件，忽略 sortedcontainers 等外部依赖；
- 自动发现“从未被执行”的自有模块（如遗漏的工具函数文件），辅助完善测试边界。
⚠️ 注意事项：
- 不要尝试为第三方库编写测试用例——这既违反封装原则，又易因版本升级导致测试失效；
- 若项目依赖 sortedcontainers 的特定行为（如 SortedDict.__setitem__ 的排序逻辑），应在你自己的集成测试中验证其 使用效果，而非直接测试其内部实现；
- 运行 coverage report --source=. 后，若仍有低覆盖文件，说明它们确实未被测试调用，需针对性补充单元测试或检查是否为冗余代码。
最终，你的覆盖率报告将聚焦核心价值：你写的代码是否被充分验证？ 而不是“你有没有测试别人写的代码？”——这才是测试覆盖率指标的本意。
