如何在vscode中编写单元测试与查看覆盖率【教程】

12次阅读

VS Code需配合jest/pytest/dotnet test等实际测试运行器才能启用测试功能,内置Testing视图仅作ui层,覆盖率需额外配置生成lcov.info或html报告。

如何在vscode中编写单元测试与查看覆盖率【教程】

VS Code 本身不内置单元测试或覆盖率功能,必须靠扩展 + 项目配套工具链驱动——直接装插件没用,关键在配置好 jestpytestdotnet test 这类实际执行器。

确认项目已配好测试运行器(不是只装了 VS Code 插件)

VS Code 的测试面板(Testing view)只是 UI 层,底层依赖项目里真实可执行的测试命令。比如:

  • javaScript/typescript 项目必须已安装 jest(或 vitest),且根目录有 jest.config.jsvite.config.ts 明确启用测试;
  • python 项目需已用 pip install pytest 安装,并确保 pytest --version 在终端能正常输出;
  • .NET 项目得有 .csproj 文件,且已通过 dotnet test 验证能跑通。

常见错误:装了 Python Test Explorer 却没装 pytest,或装了 Jest Runnernode_modules 里没 jest —— 此时点击“Run Test”毫无反应。

启用 VS Code 内置测试功能(1.78+ 版本)

新版 VS Code 自带 Testing API,无需第三方插件即可识别主流框架,但需手动启用:

  • 打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入并选择 Testing: Enable Testing
  • VS Code 会自动扫描项目,识别出 jestpytestmochadotnet test 等配置;
  • 若未识别,检查 .vscode/settings.json 是否误加了 "testing.autoDetect": "off"

识别成功后,侧边栏会出现 Testing 图标,点开就能看到测试树、运行单个测试、重新运行失败项等操作。

查看覆盖率需要额外配置(VS Code 不自带)

覆盖率数据必须由测试运行器生成,VS Code 只负责读取和渲染。不同语言路径不同:

  • javascript(Jest):在 jest.config.js 中启用 collectCoverage: true,并指定 coverageDirectory: "coverage";再安装 jest-html-reporters 或用 VS Code 扩展 Coverage Gutters 读取 coverage/lcov.info
  • Python(pytest):安装 pytest-cov,运行 pytest --cov=src --cov-report=html 生成 htmlcov/,然后用浏览器打开或配合 Live Server 插件预览;
  • 注意:Coverage Gutters 扩展只解析 lcov.info,对 coverage.py 默认生成的 .coverage 文件无效。
jest.config.js module.exports = {   collectCoverage: true,   coverageDirectory: "coverage",   coverageReporters: ["lcov", "text-summary"],   collectCoverageFrom: ["src/**/*.{js,ts}"] };

调试单个测试用例比想象中更直接

不用改 launch.json 就能断点调试,前提是测试运行器支持 —— Jest、pytest、dotnet test 全部原生支持:

  • 把光标放在某个 testit 函数内部;
  • 右键 → Debug Test(或点击测试名左侧的绿色虫子图标);
  • VS Code 会自动生成临时调试配置,启动带调试器的进程;
  • 注意:若报错 Cannot find module 'jest',说明调试环境没走项目 node_modules,需确认工作区是项目根目录,且终端默认 shell 已激活正确环境(如 venv、nvm)。

覆盖率数字容易骗人:它只统计被执行过的代码行,不反映断言质量或边界覆盖。真正要盯的是 coverage/lcov-report/index.html 里标红的逻辑分支,而不是终端里那个 92%。

text=ZqhQzanResources