在 vscode 中使用 pytest-cov 生成覆盖率报告时，vscode 调试器默认无法在断点处暂停；根本原因是 pytest-cov 与 debugpy 均需挂钩 python 执行流程。本文提供无需注释/修改 `pytest.ini` 即可兼顾覆盖率运行与可靠断点调试的完整配置方案。
问题核心在于：pytest-cov 通过底层代码插桩（tracing）收集覆盖率数据，而 VSCode 的 debugpy 调试器同样依赖 Python 的 sys.settrace() 机制实现断点控制——二者冲突，导致调试时断点失效。
你当前在 launch.json 中通过 "PYTEST_ADDOPTS": "--no-cov" 尝试禁用覆盖率，但该环境变量对 VSCode 测试资源管理器（Test Explorer）启动的调试会话并不生效——因为 Test Explorer 启动调试时实际调用的是 pytest 命令行，并优先读取 pytest.ini 中的 addopts，而 PYTEST_ADDOPTS 环境变量仅影响直接调用 pytest 命令的场景，不覆盖 pytest.ini 的硬编码配置。
✅ 正确解法：将 --no-cov 显式注入 VSCode 测试框架的全局参数中，而非依赖调试环境变量。
✅ 推荐方案：配置 settings.json 全局禁用测试调试时的 coverage
在项目根目录的 .vscode/settings.json（或用户级设置）中添加：
{
"python.testing.pytestArgs": [
"--import-mode=importlib",
"--no-cov"
],
"python.testing.pytestEnabled": true,
"python.testing.pytestPath": "pytest"
}? 说明： "python.testing.pytestArgs" 是 VSCode 测试资源管理器（Test Explorer）和“Debug Test”右键菜单所使用的 pytest 参数列表； --no-cov 在此层级生效，会覆盖 pytest.ini 中的 --cov=... 配置（pytest 参数优先级：命令行 > 环境变量 > 配置文件）； --import-mode=importlib 是现代 pytest 推荐模式（尤其配合 src/ 结构），避免 conftest.py 导入问题，建议保留。
✅ 补充：保持覆盖率运行不受影响
你的 pytest.ini 可完全保留原样，无需任何注释：
[pytest]
addopts = "--cov=src/ --cov-report=lcov:lcov.info --cov-report=term"
env =
TESTING=true
ENV=local✅ 覆盖率照常工作：当你通过终端执行 pytest、或点击 Test Explorer 顶部的 “Run All Tests” 播放图标（非 Debug）时，pytest.ini 生效，覆盖率正常生成。
✅ 断点照常生效：当你右键单个测试 → “Debug Test”，或使用 launch.json 中 "purpose": ["debug-test"] 的配置时，settings.json 中的 --no-cov 优先生效，debugpy 可自由接管 trace 控制权。
⚠️ 注意事项
- ❌ 不要依赖 PYTEST_ADDOPTS 环境变量解决此问题（它对 VSCode 测试调试流程无效）；
- ❌ 避免在 launch.json 中为 "purpose": ["debug-test"] 配置 program: "${file}" + env.PYTEST_ADDOPTS —— 这种方式绕过了 VSCode 测试框架，属于“手动运行脚本”模式，无法联动 Test Explorer 的状态同步；
- ✅ 若需为特定调试场景（如调试某个非测试脚本）启用 coverage，可另建独立 launch.json 配置，不带 "purpose": ["debug-test"]，并显式传参 --cov；
- ✅ 建议升级至 pytest>=7.0 和 pytest-cov>=4.0，兼容性更佳。
✅ 总结
| 场景 | 触发方式 | 是否启用 coverage | 是否支持断点 |
|---|---|---|---|
| 运行全部测试 | Test Explorer → ▶️ 播放按钮 | ✅（pytest.ini 生效） | ❌（非调试模式） |
| 调试单个测试 | Test Explorer → 右键 → Debug Test | ❌（settings.json 中 --no-cov 覆盖） | ✅ |
| 终端手动运行 | pytest --cov=src/ ... | ✅ | ❌（非调试） |
| 终端手动调试 | python -m debugpy --wait-for-client --listen 127.0.0.1:5678 -m pytest test_foo.py | ❌（需加 --no-cov） | ✅ |
通过分离「测试执行配置」（settings.json）与「覆盖率默认配置」（pytest.ini），你就能真正实现：一次配置，双模无忧——运行有报告，调试有断点。
