Pytest在VS Code中需手动配置pytest-cov和Coverage Gutters插件才能生成并显示覆盖率：必须使用--cov-report=xml:coverage.xml指定XML输出、确保路径一致、coverage.xml位于项目根目录且非空，否则染色失败或显示0%。
Pytest 能在 VS Code 里跑起来，但默认不生成覆盖率、也不自动染色——必须手动配好 pytest-cov 参数 + Coverage Gutters 插件，并确保路径对得上。
Pytest 在 VS Code 里根本没反应？先检查这三件事
点击“Run Test”没输出、测试树为空、右键菜单灰色——不是插件没装，而是底层命令根本跑不通：
-
pytest --version在 VS Code 集成终端里执行失败？说明没装pytest或不在 PATH 里；虚拟环境没激活也会导致此问题 -
python.testing.pytestEnabled是false？打开设置搜 “pytest enabled”，必须设为true - 项目根目录下没有
test_*.py或*_test.py文件？VS Code 默认只扫描这两种命名模式，tests/子目录也要有__init__.py才能被识别
覆盖率数字显示为 0% 或直接报 “No coverage data found”
这是最常踩的坑：VS Code 不生成数据，只读取。你运行测试时没让 pytest-cov 输出文件，Coverage Gutters 就只能干瞪眼：
- 必须用
--cov-report=xml:coverage.xml（不是默认的.coverage二进制文件），因为Coverage Gutters只认 XML 格式 -
--cov=.中的.表示当前目录，但如果源码在src/下，就得改成--cov=src，否则覆盖率统计范围为空 - 检查
coverage.xml是否真生成了：它必须出现在项目根目录（不是src/或tests/下），且文件非空
代码行没染色，但 coverage.xml 明明存在
染色失败几乎全是路径映射问题。Coverage Gutters 拿 coverage.xml 里的 <source> 和 <class name="xxx"> 去匹配你当前打开的文件路径，稍有不一致就失效：
- XML 里
<source>/home/user/project/src</source>，而你在 VS Code 里打开的是./src/main.py？路径前缀不一致，染色失败 - 用 WSL 或 Docker 运行测试？XML 中路径可能是
/mnt/c/project/...，而 VS Code 工作区是C:\project\...，需用sed或脚本统一替换 - VS Code 设置里开了
python.defaultInterpreterPath指向远程解释器？Coverage Gutters 无法跨环境解析路径，建议本地运行测试生成报告
想点一下就跑测试+刷新覆盖率？别靠右键菜单
VS Code 测试面板右键“Run Test”或“Debug Test”不会触发 Coverage Gutters 刷新——它只调用 pytest 命令，不通知插件重载数据：
- 在
.vscode/tasks.json里定义一个 task，命令为：pytest --cov=. --cov-report=xml:coverage.xml --cov-report=term-missing，并设"isBackground": true - 再配一个
launch.json的配置，用"preLaunchTask": "pytest-coverage"，这样每次调试前自动更新报告 - 或者更简单：按
Ctrl+Shift+P→ 输入Coverage Gutters: Refresh手动刷一次，比等自动靠谱
真正卡住人的从来不是“怎么装”，而是 coverage.xml 里路径和编辑器里文件路径的毫厘之差，以及你以为“点了就能出数”，其实得自己把命令链串严实。
