如何使用coverage.py跳过import与def语句的覆盖率统计？

这个问题我太懂了——之前做Python项目覆盖率统计时，也被那些“躺赢”的import和def语句搞晕过，明明没用到的模块却占了覆盖率数据，完全干扰判断！下面几个实用方法可以帮你搞定：

1. 通过配置文件排除无关文件 #

最推荐的方式是创建一个.coveragerc配置文件，在里面明确指定要排除的文件或目录，这样每次运行coverage都会自动生效。比如：

[run]
omit =
    # 排除测试目录
    */tests/*
    # 排除仅被导入但未使用的模块
    */utils/unused_helper.py
    # 也可以用通配符排除整个目录
    */third_party/*

如果只是临时测试，也可以直接在命令行用--omit参数：

coverage run --omit="*/unused_modules/*, */tests/*" your_main_script.py

2. 限定统计的源代码范围 #

如果你的项目结构清晰，只需要统计核心业务代码目录，可以用--source参数指定要覆盖的范围，这样coverage只会统计这个目录下的文件，其他被导入的外部依赖或无关模块都不会被纳入统计：

coverage run --source=my_project/core,my_project/services your_main_script.py

对应的配置文件写法：

[run]
source =
    my_project/core
    my_project/services

3. 用--include精准指定要统计的文件 #

和omit相反，include参数可以明确指定只统计哪些文件，适合你能清晰列出所有需要覆盖的代码文件的场景：

coverage run --include="my_project/**/*.py" your_main_script.py

小提示：区分“被导入但未使用”和“必要的导入” #

如果有些模块是项目启动时必须导入的（比如初始化配置），但确实没有被业务逻辑调用，你可以单独把这些模块加入排除列表，或者在模块内部用# pragma: no cover注释标记那些不需要统计的行——不过这种情况更适合单个行的排除，而非整个文件。

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