重构无单元测试的Python遗留项目：如何生成常规单元测试覆盖率报告并识别工作目录内未测试文件

嘿，我来帮你解决这个覆盖率报告的问题！你现在遇到的核心问题是：用nose时会把第三方包的代码也统计进去，而用unittest+coverage时又没把所有未测试的项目文件（比如baz.py）纳入报告。下面给你一步步梳理解决方案：

一、先把 unittest + coverage 配置得更顺手 #

你当前用的命令python.exe -m unittest discover -s . && coverage report -m其实已经能跑测试，但有两个小瑕疵：一是没把所有src下的文件都纳入统计（比如你的baz.py就没出现在报告里），二是没有明确排除第三方包的代码（虽然这次没显示，但最好提前配置避免后续踩坑）。

1. 新建 coverage 配置文件 .coveragerc #

在项目根目录（就是包含scripts、src、tests的那个文件夹）创建一个.coveragerc文件，这个文件能帮我们固定覆盖率的规则，不用每次敲命令都加一堆参数：

[run]
# 只追踪src目录下的我们自己的代码
source = src
# 强制把src下所有.py文件都纳入统计，哪怕没被任何测试引用（这样就能看到baz.py这类未测试的文件了）
include = src/**/*.py
# 排除虚拟环境、第三方包、缓存目录，避免乱统计
omit =
    */venv/*
    */site-packages/*
    */__pycache__/*

[report]
# 显示每个文件里未被覆盖的行数
show_missing = True
# 按覆盖率从高到低排序，方便快速找到问题文件
sort = Cover

2. 正确执行测试并生成报告 #

改用coverage run来启动测试，这样coverage能准确追踪我们指定的所有文件：

# 先清除之前的旧覆盖率数据，避免干扰
coverage erase
# 运行tests目录下的所有单元测试
coverage run -m unittest discover -s tests
# 生成带详细缺失行的文本报告
coverage report -m
# （可选）生成HTML可视化报告，打开htmlcov/index.html就能直观看到每个文件的覆盖情况
coverage html

执行完这些命令后，你会看到报告里包含src下的所有文件（比如baz.py、utils/init.py），完全没有第三方包的内容，还能清楚看到每个文件哪些行没被覆盖。

二、修复 nose 命令的问题 #

你之前的nose命令犯了两个关键错误：

1. -w ..\src把测试目录指定成了src，但你的测试文件明明在tests目录下，这才导致了Ran 0 tests的尴尬情况；
2. --cover-inclusive会把所有被导入的文件都统计，包括第三方包，所以才会出现一堆site-packages里的内容。

1. 用正确的nose命令（配合上面的.coveragerc） #

有了刚才的.coveragerc配置，我们只需要调整nose的命令即可：

# 先清除旧数据
coverage erase
# 运行tests目录下的测试，同时启用覆盖率统计
nosetests -s tests --with-coverage --cover-erase --cover-html

这次执行后，nose会自动遵循.coveragerc里的规则，生成的报告只会包含你src目录下的文件，不会出现第三方包的冗余内容，同时也能看到所有未测试的项目文件。

三、额外小技巧：快速找出未写测试的文件 #

如果想快速知道src下哪些文件还没有对应的测试文件，可以用一行命令搞定：

• Windows PowerShell：

Get-ChildItem src -Filter *.py | ForEach-Object {
    $testFile = "tests/test_$($_.Name)"
    if (-not (Test-Path $testFile)) {
        Write-Host "⚠️  Missing test file for: $($_.FullName)"
    }
}

• Linux/macOS Bash：

for file in src/*.py; do
    test_file="tests/test_$(basename $file)"
    if [ ! -f "$test_file" ]; then
        echo "⚠️  Missing test file for: $file"
    fi
done

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