为何我的Pytest测试函数未被Coverage工具检测到覆盖？

测试用例的错误 #

你写的测试用例里，assert specs.add('3', 4) == None 和 assert specs.add(3, '4') == None 逻辑完全错误：当传入非整数参数时，add函数会直接抛出ValueError，raise语句会立刻终止函数执行，后面的return None是永远不会被执行的死代码。这意味着这两个断言根本不会被执行，反而会直接导致测试失败——但你说测试全部通过，要么是这两行代码没被执行到，要么是你运行测试时用了某种未写出的异常捕获逻辑。

正确的异常验证方式应该用pytest.raises：

def test_add(): 
    assert specs.add(1, 3) == 4, "failed on positive integers" 
    assert specs.add(-5, -7) == -12, "failed on negative integers" 
    assert specs.add(-6, 14) == 8, "failed on a mix of positive and negative integers" 
    # 验证a为非整数时抛出指定异常
    with pytest.raises(ValueError) as exc_info:
        specs.add('3', 4)
    assert str(exc_info.value) == 'a is not an integer'
    # 验证b为非整数时抛出指定异常
    with pytest.raises(ValueError) as exc_info:
        specs.add(3, '4')
    assert str(exc_info.value) == 'b is not an integer'

Coverage显示函数未被覆盖的原因 #

你碰到的这个问题，主要和两个点有关：

• 死代码导致的coverage标记异常：add函数里raise后的return None是不可达代码，coverage会标记这些行未覆盖。如果你的coverage配置严格要求全量覆盖，可能会被误判为整个函数未覆盖（建议打开HTML报告，查看具体哪几行未被标记）。
• 测试用例未完整执行函数逻辑：如果测试用例中那些触发异常的代码没被执行到（比如前面的断言失败导致测试提前终止，但你说测试全过，这个可能性很低），或者coverage命令没正确追踪到specs.py文件。检查下你的coverage命令是否正确，比如：

  coverage run -m pytest
  coverage html
  

  确保specs.py在coverage的扫描范围内。

额外优化：移除无用代码 #

add函数里的return None完全没有意义，直接删掉即可：

def add(a, b): 
    """Add two numbers.""" 
    if not isinstance(a, int): 
        raise ValueError('a is not an integer') 
    if not isinstance(b, int): 
        raise ValueError('b is not an integer') 
    return a + b 

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