VSCode本身不生成单元测试报告，必须依赖外部工具配合；需正确安装pytest-html插件、在settings.json中配置python.testing.pytestArgs添加--html和--self-contained-html参数，并确保测试文件命名规范及工作目录设置正确。
VSCode 本身不生成单元测试报告，必须靠外部工具配合——核心是装对插件、选对框架、配对参数，三者缺一不可。直接点“运行测试”出不了 HTML 报告，这是最常被误以为能一键搞定的坑。
pytest-html 是最直接可用的 Python 测试报告生成器
它把 pytest 的结果转成可交互的 HTML 页面，支持失败用例高亮、执行时间统计、跳过项分类展示。不依赖 VSCode 插件，纯 CLI 工具，但需和 VSCode 的测试配置联动。
- 安装命令：
pip install pytest-html - 验证是否生效：终端运行
pytest --html=report.html，生成 report.html 文件即成功 - 注意：不要装
pytest-report或pytest-testreport，它们已弃用或不维护，容易报ImportError: No module named 'pytest_report' - 如果项目用了虚拟环境，确保在激活状态下安装，否则 VSCode 可能找不到模块
VSCode 里跑出 HTML 报告的关键配置
光装 pytest-html 不够，VSCode 默认不会把它加进测试命令里。你得手动告诉它：“跑测试时，顺手给我生成 HTML”。这靠 python.testing.pytestArgs 实现。
- 在项目根目录的
.vscode/settings.json中添加： "python.testing.pytestArgs": ["--html=tests/report.html", "--self-contained-html"]-
--self-contained-html表示把 CSS/JS 打包进单个 HTML 文件，方便离线查看或发给同事 - 别写成
--html=./report.html——相对路径以python.testing.cwd为准，不是当前文件所在目录 - 如果报告没生成，先检查
python.testing.cwd是否设为"${workspaceFolder}"，否则 pytest 可能往错地方写文件
为什么右键“Run Test”没反应，或 report.html 空白？
常见原因不是代码写错了，而是工作流断在了中间环节。VSCode 的测试 UI 只是壳，底层全靠 pytest CLI 执行，任何一环掉链子都会静默失败。
立即学习“Python免费学习笔记（深入）”；
- 终端手动运行
pytest --html=report.html成功，但 VSCode 里不生成 → 检查python.testing.pytestArgs是否被其他设置覆盖（比如python.testing.pytestPath已废弃，删掉） - report.html 打开是空白页 → 查看文件大小是否为 0KB，若是，说明 pytest 根本没跑测试（可能测试文件名不符合
test_*.py规则，或python.testing.pytestArgs里漏了-v导致无输出触发报告生成） - 报错
TypeError: __init__() got an unexpected keyword argument 'log_file'→ 说明你混装了旧版pytest-html <4.0和新版 pytest，升级到pytest-html >=4.0即可 - HTML 里看不到源码行号或跳转链接 → 这是正常现象，pytest-html 默认不嵌入源码，如需深度追踪，得搭配
--cov和pytest-cov
真正麻烦的不是装工具，而是让 VSCode 的测试发现逻辑、pytest 的参数解析、文件系统路径三者对齐。哪怕只差一个斜杠或一个空格，report.html 就可能生成在你完全想不到的地方，或者根本没生成。建议每次改完配置后，在集成终端里手动跑一遍 pytest --html=report.html 确认基础链路通了，再回 VSCode 点按钮。
