使用coverage.py生成的HTML覆盖率报告未纳入index.html求助

先确认覆盖率收集与报告生成的流程是否正确 #

如果是单次运行收集覆盖率：

• 执行coverage run your_main_script.py（用测试框架的话，比如pytest就用coverage run -m pytest）
• 再执行coverage html生成HTML报告

如果是分多次收集后合并：

1. 每次收集时指定不同的数据文件：coverage run --data-file=.coverage.moduleA module_a_test.py
2. 合并所有数据文件：coverage combine .coverage.moduleA .coverage.moduleB
3. 最后生成HTML报告：coverage html

检查覆盖率配置是否排除了目标文件 #

coverage默认会过滤第三方库、测试文件等，可通过.coveragerc配置调整：
在项目根目录创建或修改.coveragerc：

[run]
source = .  # 指定分析当前目录下的代码
include = **/*.py  # 明确包含所有Python文件
omit =
    tests/**/*.py  # 排除测试文件（按需调整）
    venv/**/*.py   # 排除虚拟环境文件

验证覆盖率数据是否包含目标文件 #

先通过文本报告确认数据完整性：

• 执行coverage report -m，查看输出列表里是否有你期望的文件。如果这里没有，说明收集阶段就没捕获到这些文件的执行数据，要检查coverage run是否真的运行了相关代码。

排查日志与清理旧文件 #

• 运行coverage html时留意控制台输出，若出现“Excluding files matching”或“No data collected”，对应调整配置或重新收集数据。
• 删除旧的.coverage系列文件和htmlcov目录，重新执行收集+生成流程，避免旧数据干扰。

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