需借助代码覆盖率工具评估测试覆盖程度并识别未测逻辑路径：一、用pytest-cov生成HTML报告；二、启用--cov-branch检测缺失分支；三、结合diff覆盖率聚焦新增代码；四、用mutpy进行变异测试验证测试质量；五、解析coverage.xml提取未覆盖行生成补测建议。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已拥有单元测试套件，但希望评估其对源代码的覆盖程度并识别未被测试的逻辑路径，则需要借助代码覆盖率工具对测试执行过程进行插桩与统计。以下是实现此目标的具体步骤：
一、使用 pytest-cov 生成覆盖率报告
pytest-cov 是 Python 生态中主流的覆盖率分析插件，它基于 coverage.py，在运行 pytest 时自动收集行覆盖、分支覆盖等数据，并生成可读报告。
1、在项目根目录下安装依赖：pip install pytest pytest-cov。
2、执行测试并生成覆盖率数据文件：pytest --cov=src --cov-report=html --cov-fail-under=80（其中 src 为待测代码包名，80 表示覆盖率低于 80% 则构建失败）。
3、打开生成的 htmlcov/index.html 文件，在浏览器中查看各模块的行覆盖百分比及高亮显示的未执行代码行。
二、启用分支覆盖率以识别缺失路径
仅统计代码行是否被执行不足以发现隐藏的控制流漏洞，例如 if/else 中某一分支从未触发。启用分支覆盖可检测条件语句中所有可能走向是否被测试用例激活。
1、修改 pytest 命令，添加 --cov-branch 参数：pytest --cov=src --cov-branch --cov-report=term-missing。
2、终端输出将列出每个文件中未覆盖的行号及具体缺失分支（如 "line 45, branch 1 not taken"）。
3、针对标记为 "not taken" 的分支，检查对应条件表达式的所有输入组合，确认是否存在未构造的测试用例。
三、结合 diff 覆盖率定位新增未覆盖代码
当代码库持续演进时，新提交的变更可能引入未被现有测试覆盖的逻辑。diff 覆盖率工具可聚焦于本次变更范围内哪些行未被执行。
1、安装支持 diff 分析的插件：pip install pytest-cov coverage[toml]。
2、在 pyproject.toml 中配置 [tool.coverage.run] 区块，设置 source = ["src"] 并启用 dynamic_context = "test"。
3、运行命令：git diff origin/main...HEAD --name-only | grep '\.py$' | xargs -r pytest --cov=src --cov-report=term-missing --cov-fail-under=0，仅对差异文件执行测试并报告其内部未覆盖行。
四、使用 mutpy 进行变异测试辅助识别薄弱测试集
即使行覆盖率达 100%，测试也可能无法捕获逻辑错误。mutpy 通过自动注入小范围代码变异（如将 == 改为 !=），验证测试能否检测出这些人为缺陷，从而反向提示测试用例是否真正具备辨别能力。
1、安装变异测试工具：pip install mutpy。
2、执行变异分析：mutpy --target src.module_name --unit-test tests.test_module_name --report（替换为目标模块与对应测试模块）。
3、若出现 "SURVIVED" 状态的变异体，说明当前测试未触发该变异导致的行为变化，需补充能暴露该逻辑缺陷的新测试用例。
五、解析 coverage.xml 输出并提取未覆盖行用于自动化建议
coverage.py 可导出标准 XML 格式报告，便于脚本解析并生成待补充测试的函数级或行级清单。
1、生成 XML 报告：coverage xml -o coverage.xml。
2、使用 Python 脚本加载 coverage.xml，遍历
3、按函数聚合未覆盖行，输出形如 "function_x in module_y: lines [12, 15, 18]" 的结构化建议列表，供开发人员快速定位补测位置。
