VSCode调试pytest时断点失效（含pytest-cov）的解决方法咨询

方案1：用环境变量动态控制pytest.ini配置 #

修改你的pytest.ini，将addopts改为通过环境变量动态赋值：

[pytest]
# 无指定环境变量时默认启用覆盖率，有变量则使用变量值
addopts = ${PYTEST_COV_OPTS:--cov=src --cov-report=html}

然后在VSCode的launch.json调试配置中，添加环境变量清空覆盖率参数：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: pytest 调试",
            "type": "python",
            "request": "launch",
            "module": "pytest",
            "env": {
                "PYTEST_COV_OPTS": ""
            }
        }
    ]
}

正常从测试资源管理器运行时，因无PYTEST_COV_OPTS变量，会自动启用覆盖率；调试时该变量为空，addopts不包含--cov相关参数，断点可正常触发。

方案2：调试时指定专用配置文件 #

创建调试专用的pytest-debug.ini，只保留非覆盖率的必要参数：

[pytest]
addopts = -v --tb=short

在launch.json中添加参数指定该配置文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: pytest 调试",
            "type": "python",
            "request": "launch",
            "module": "pytest",
            "args": [
                "-c", "pytest-debug.ini"
            ]
        }
    ]
}

这种方式完全隔离正常测试与调试的配置，适合需要不同参数组合的场景。

方案3：直接在调试参数中强制禁用覆盖率 #

若不想修改pytest.ini，可在launch.json的args中直接添加--no-cov：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: pytest 调试",
            "type": "python",
            "request": "launch",
            "module": "pytest",
            "args": [
                "--no-cov"
            ]
        }
    ]
}

注：若此方法无效，说明pytest.ini中的--cov参数优先级高于--no-cov，建议改用方案1或2。

原因说明 #

pytest参数优先级为命令行参数 > 环境变量 > 配置文件，但PYTEST_ADDOPTS是追加到配置文件addopts之后而非覆盖。若配置文件已包含--cov，仅通过PYTEST_ADDOPTS="--no-cov"可能因参数顺序问题无法禁用覆盖率，因此需要用上述方法直接覆盖或动态控制配置。

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