如何mock os.path.exists且不对VSCode调试器造成负面影响？

问题原因 #

你通过autouse=True的全局fixture替换了os.path.exists的实现，VSCode调试器与测试代码运行在同一进程空间，调试器自身的文件路径校验逻辑也依赖os.path.exists，被强制返回False后就会出现功能异常。

解决方案1：使用side_effect过滤路径，保留原生调用能力 #

先保存原生的os.path.exists方法，仅对业务需要模拟的路径返回自定义值，其他路径走原生逻辑，不会影响调试器调用：

import os
@pytest.fixture(autouse=True)
def init_mocks(monkeypatch):
    # 保存原生exists方法
    original_exists = os.path.exists
    def mock_exists(path):
        # 可自行修改匹配规则，仅对业务测试需要的路径返回模拟值
        target_paths = ["/your/business/path1", "/your/business/path2"]
        if path in target_paths:
            return False
        # 其他路径走原生逻辑，不影响调试器
        return original_exists(path)
    monkeypatch.setattr(mymodule.os.path, "exists", mock_exists)

解决方案2：取消autouse，按需使用mock #

去掉fixture的autouse=True参数，仅在需要用到该mock的测试用例上显式引入，缩小mock影响范围：

# 去掉autouse=True，不再全局生效
@pytest.fixture()
def mock_os_path_exists(monkeypatch):
    monkeypatch.setattr(
        mymodule.os.path, "exists", Mock(return_value=False))

# 仅在需要的测试用例中引入fixture
def test_my_business_logic(mock_os_path_exists):
    # 测试逻辑
    pass

解决方案3：使用上下文管理器限定mock生效范围 #

如果仅在单测的某一段逻辑中需要mockos.path.exists，可以用上下文管理器控制生效周期，退出后自动恢复原生实现：

from unittest.mock import patch

def test_my_business_logic():
    # 仅在with代码块内生效
    with patch("mymodule.os.path.exists", return_value=False):
        # 测试逻辑
        pass
    # 此处os.path.exists已恢复原生实现

小提示：如果你的业务代码里的导入写法是from os.path import exists，直接patch业务模块下的exists即可，patch目标写为mymodule.exists，这种写法的mock影响范围仅局限于当前业务模块，不会影响其他模块包括调试器的os相关调用。

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