Pytest Coverage误报导入与常量赋值行未覆盖，求调试方案

针对你遇到的部分文件导入语句、常量赋值行未被Coverage统计的问题，以下是具体排查调试步骤：

• 确认模块加载路径与唯一性
  检查目标文件是否存在同名模块被误加载，或者在测试执行前已被其他模块提前导入。可以在测试函数中添加代码打印模块路径：

  import sys
  from myproj import problem_module
  print(problem_module.__file__)
  print(sys.modules.get('myproj.problem_module'))
  

  确保加载的是你预期的文件，而非其他路径下的同名文件。

• 开启Coverage调试日志
  修改tox命令，添加Coverage调试参数，追踪文件的监测与统计过程：
  在tox.ini的[testenv:code]的commands中修改为：

  pytest --cov myproj --cov-report term-missing --cov-fail-under=70 --cov-debug=trace,config {posargs}
  

  运行测试后，查看日志中关于目标文件的加载记录，确认Coverage是否正确追踪到该文件的执行。

• 排查导入时机问题
  若目标模块是在conftest.py顶层、全局fixture中提前导入，可能Coverage尚未启动追踪，导致导入行未被统计。可以将导入移至测试函数内部，或使用延迟导入的方式验证：

  def test_problem_module():
      from myproj import problem_module
      assert problem_module.CONST == 123
  

• 检查Coverage排除规则
  确认项目根目录是否存在.coveragerc配置文件，或tox命令中是否包含--cov-exclude参数，排查是否误将目标文件加入排除列表。也可以直接在命令中强制指定包含目标文件：

  pytest --cov myproj --cov myproj/problem_module.py --cov-report term-missing --cov-fail-under=70 {posargs}
  

• 绕过tox直接测试
  进入tox创建的虚拟环境（通常在.tox/code目录下），直接运行Coverage命令：

  source .tox/code/bin/activate
  coverage run -m pytest tests/test_problem_file.py
  coverage report
  

  若结果与tox运行一致，说明问题出在Coverage或代码逻辑；若不一致，则排查tox的环境配置是否存在冲突。

• 验证代码执行完整性
  确认目标文件的导入过程无静默异常，可在测试中打印常量值验证是否执行了赋值语句：

  def test_const_exists():
      from myproj import problem_module
      assert hasattr(problem_module, 'CONST')
      print(problem_module.CONST)
  

  同时检查目标文件中是否存在条件分支（如if __name__ == '__main__'）包裹常量赋值，导致导入时未执行。

• 调整依赖版本
  尝试兼容版本组合，比如降级Coverage到7.3.x，或升级pytest-cov至最新版，排查是否存在版本兼容问题：
  在tox.ini的[testenv:code]的deps中指定版本：

  deps=
      coverage==7.3.2
      pytest
      pytest-cov==4.1.0
      pytest-mock
  

附用户提供的示例代码与配置 #

coverme.py

import logging

logger = logging.getLogger(__name__)
some_obj = SomeObject(foo='bar')
CONST = 123


def myfunc() -> bool:
    return True


def otherfunc() -> bool:
    """
    nice pydoc goes here
    """
    return CONST

test_coverme.py

import logging
from myproj import coverme

logger = logging.getLogger(__name__)


def test_myfunc():
    logger.debug('test myfunc')
    assert coverme.myfunc()

tox.ini

[tox]
envlist = code,flake8
minversion = 2.0

[pytest]
testpaths = tests

[testenv:code]
basepython = python3
deps=
    coverage
    pytest
    pytest-cov
    pytest-mock

commands =
    pytest --cov myproj --cov-report term-missing --cov-fail-under=70 {posargs}

[testenv:flake8]
basepython = python3
skip_install = true
deps = flake8
commands = flake8 setup.py myproj tests

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