壹贰线报 · 开源免费测试工具核实
核实时点:2026 年 11 月
一句话结论
Vitest 是 Vite 官方原生单元测试框架,完全 MIT 开源,本地和自托管 CI 永久免费:基于 ESM 原生、开箱即用 TS 与 Vite 模块图、兼容 Jest API、开箱即用 watch 模式与交互式 UI、覆盖率同时支持 v8(默认更快)与 istanbul(跨环境兼容),与 Vue/React/Svelte/Solid/Lit/Astro 等现代前端框架深度集成,是 2026 年 Vite/Vue/React 项目的首选单元测试工具。
📌 上手前要看的 3 个细节(以官方文档为准)
核心 MIT 永久免费,"Vitest Cloud"是附加付费服务——Vitest 本地运行、npm 安装、CI(GitHub Actions/GitLab CI/自建 Docker)全部 0 成本;付费的是 StackBlitz 收购后推出的 Vitest Cloud(Browser 模式云端并发、跨浏览器云测、企业 SSO),不影响本地+自托管全功能免费。
v8 覆盖率自 v3.2.0 起精度对齐 Istanbul——默认走 v8 覆盖(@vitest/coverage-v8)无需预插桩速度快;Firefox/Bun/Cloudflare Workers 这类非 V8 环境用 @vitest/coverage-istanbul(预插桩+全环境兼容),两套报告精度自 v3.2.0 起一致。
Browser Mode 是 Vitest 3.x 杀手级能力——直接在真实浏览器(Chrome/Firefox/WebKit via Playwright)里跑单元测试,告别 jsdom 误判;
@vitest/browser本地免费无限量,云并发才走 Vitest Cloud 付费。
🎁 两个隐藏福利
@vitest/ui交互式 UI 完全免费——npx vitest --ui启动图形化面板,实时过滤、重跑、源码定位、覆盖率热图,比 Jest 的 jest --watchAll 体验好一个数量级;expect-type内置 TypeScript 类型断言——Vitest 自带.toMatchTypeOf、.toEqualTypeOf做编译期类型检查,不用再装tsd/ts-expect等额外包。
永久免费额度一览
维度 | 免费额度(本地/自托管 CI) |
|---|---|
开源协议 | MIT(可商用、可二次分发、可做内部/商业产品) |
价格 | $0 永久,无 API Key、无账号注册、无配额 |
核心运行器 | 基于 Vite 模块图 + ESM 原生,HMR 级 watch 重跑 |
浏览器兼容 | Node.js(v18+)+ Browser Mode(Chrome/Firefox/WebKit via Playwright,本地免费) |
TypeScript 支持 | 零配置,直接 import .ts/.tsx,开箱 tsconfig paths |
API 兼容性 | Jest/Chai/Sinon 语法兼容,describe/it/expect/mock/spy/vi.fn/vi.mock 全对齐 |
Watch 模式 | 文件变更级 HMR 重跑,毫秒级反馈(比 Jest 快 5-10 倍) |
交互式 UI |
|
覆盖率 | v8(默认,AST 重映射精度对齐 Istanbul)+ istanbul(全环境兼容)双 Provider,支持 lcov/html/json/text/cobertura 输出,thresholds 门禁免费 |
框架支持 | Vue(@vitejs/plugin-vue 官方)+ React + Svelte + Solid + Lit + Astro + Nuxt(@nuxt/test-utils)+ Next.js(@vitejs/plugin-react + next-vitest) |
快照 / Snapshot | toMatchSnapshot / toMatchInlineSnapshot 全支持 |
Mock 能力 | vi.mock / vi.spyOn / vi.fn / vi.useFakeTimers / vi.hoisted / doMock |
并发 / Workers | 默认多线程 workers(Node worker_threads)+ single-thread 兼容模式、--shard 分片 |
浏览器真实环境 | Browser Mode(Playwright 驱动,本地免费),告别 jsdom 行为差 |
内建功能 | Chai 断言+Sinon spy/stub+expect-type 类型断言+Mock Date/Timers+模块 Mock |
报告 | default/verbose/dot/json/junit/html 内置 reporter 免费 |
VS Code 插件 | 官方 |
CI 友好 | GitHub Actions / GitLab CI / Jenkins / Vercel / Netlify 零成本跑,官方 Docker 镜像 |
核心能力拆解
⚡ Vite 原生 ESM,速度比 Jest 快 5-10 倍
Vitest 复用 Vite 的开发服务器与模块图,测试文件走 ESM 原生加载,第一次冷启动后 watch 模式只重跑变更文件的依赖图,对 Vite/Vue/React 项目几乎零配置。官方基准测试里,Vue 3 源码测试套件在 Vitest 下跑 3000+ 用例秒级完成,对比 Jest 冷启动时间差 5-10 倍。
🧪 Jest 兼容 API + Chai 断言,几乎零成本迁移
import { describe, it, expect, vi } from 'vitest'
import { mount } from '@vue/test-utils'
import Counter from './Counter.vue'
describe('Counter.vue', () => {
it('increments on click', async () => {
const wrapper = mount(Counter)
await wrapper.find('button').trigger('click')
expect(wrapper.text()).toContain('1')
})
it('calls onSubmit with debounced input', () => {
const fn = vi.fn()
// ...
})
})
describe / it / test / expect / beforeEach / vi.mock / vi.fn / vi.spyOn / vi.useFakeTimers / snapshot 全对齐 Jest 语义,现有 Jest 测试基本只改 import 源即可迁移;Chai 断言库兼容 .to.be / expect.extend 插件生态。
🖥️ 交互式 UI + Watch 模式,开发体验拉满
npx vitest --ui(需 npm i -D @vitest/ui)启动 http://localhost:51204/vitest/ :实时用例树、源码侧栏、覆盖率热力图、失败快照 diff、控制台输出、模块图可视化,完全免费。CLI watch 模式默认开启,按 r 重跑、f 重跑失败、u 更新快照、c 清屏、p 按文件名过滤。
📊 v8 覆盖率(默认)+ istanbul 双 Provider,阈值门禁免费
npm i -D @vitest/coverage-v8 # 默认:V8 原生更快,v3.2.0 起精度对齐 Istanbul
# 或
npm i -D @vitest/coverage-istanbul # 跨环境(Firefox/Bun/Workers)用这个
npx vitest run --coverage
vitest.config.ts 阈值门禁:
export default defineConfig({
test: {
coverage: {
provider: 'v8',
reporter: ['text', 'html', 'lcov', 'cobertura'],
thresholds: { lines: 80, functions: 80, branches: 75, statements: 80, perFile: true },
exclude: ['**/*.test.ts', 'node_modules/', 'src/main.ts']
}
}
})
v3.2.0 起采用 AST 覆盖率重映射,v8 报告精度与 Istanbul 完全一致,同时保留 V8 原生速度与低内存优势。
🌐 Browser Mode:真实浏览器跑测试,告别 jsdom
@vitest/browser 3.x 支持 Playwright 驱动 Chrome/Firefox/WebKit 真实浏览器:
// vitest.config.ts
export default defineConfig({
test: { browser: { enabled: true, name: 'chromium', provider: 'playwright' } }
})
DOM/事件/Canvas/Web Components/CSS 等 jsdom 模拟不了的真实浏览器行为全支持,本地免费无限量;跨浏览器云端并发才走 Vitest Cloud 付费。
🔌 现代前端框架全覆盖
Vue:Vue 官方推荐单测工具,@vue/test-utils + @vitejs/plugin-vue 零配置
React:@testing-library/react + @vitejs/plugin-react
Svelte:svelte-testing-library + @svitejs/vite-plugin-svelte
Solid / Lit / Preact / Astro:官方 Vite 插件直接兼容
Nuxt:@nuxt/test-utils 内置 Vitest
Next.js:next-vitest 官方适配 + @vitejs/plugin-react
⚠️ 三个注意事项
Node 版本最低 18+,推荐 20/22 LTS——Vitest 3.x 依赖 Vite 6/7 与 ESM,Node 16 已不支持;老项目先升 Node。
CommonJS 模块需配置——Vitest 走 ESM 原生,老的 CJS 包(如 enzyme、部分 axios 旧版)通过 vite.config 的 ssr.noExternal / test.server.deps.inline 处理。
Vitest Cloud ≠ 核心收费——StackBlitz 推出的云测是可选付费附加项,本地 + GitHub Actions 自托管 CI 永远免费;任何"Vitest 要收费"的传言都是把 Vitest Cloud 误读为核心闭源。
🎯 适合 / 不适合
✅ 适合:
Vite/Vue/React/Svelte 新项目(零配置、最快)
从 Jest 迁移想提速的老项目(API 99% 兼容)
需要真实浏览器 DOM 行为测试(jsdom 搞不定 Canvas/Web Components 等)
对 TS 原生支持、watch 速度、交互式 UI 有要求的团队
CI 成本敏感(单测套件快=CI 分钟少=CI 账单低)
❌ 不适合:
Node < 18 的老项目(先升 Node 再迁)
完全基于 Karma/Mocha 老生态且拒绝迁移的项目
纯后端 Node 服务且无 Vite 构建链的项目(虽然也能跑,但不如 Node 原生工具轻)
必须兼容 IE11 的项目(Vite 5+ 已不支持 IE11)
🚀 4 步上手(含可复制代码)
第 1 步:安装(30 秒)
# 新项目推荐(Vite 5/6/7 + Vitest 3.x)
npm i -D vitest @vitest/coverage-v8
# 可选:UI 面板
npm i -D @vitest/ui
# Vue 项目额外加
npm i -D @vue/test-utils @vitejs/plugin-vue jsdom happy-dom
# React 项目额外加
npm i -D @testing-library/react @vitejs/plugin-react jsdom
第 2 步:package.json 加脚本
{
"scripts": {
"test": "vitest",
"test:ui": "vitest --ui",
"test:run": "vitest run",
"test:coverage": "vitest run --coverage"
}
}
第 3 步:vitest.config.ts(Vue 项目示例)
import { defineConfig } from 'vitest/config'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
test: {
environment: 'jsdom', // Vue/React DOM 测试用 jsdom 或 happy-dom
globals: true, // 全局 describe/it/expect,免 import
coverage: {
provider: 'v8',
reporter: ['text', 'html', 'lcov'],
thresholds: { lines: 80, functions: 80, branches: 75 },
exclude: ['**/*.test.ts', 'src/main.ts']
}
}
})
第 4 步:写第一个测试 + 跑起来
// src/utils/sum.test.ts
import { describe, it, expect } from 'vitest'
import { sum } from './sum'
describe('sum', () => {
it('adds two numbers', () => {
expect(sum(1, 2)).toBe(3)
})
it('handles negative', () => {
expect(sum(-1, 2)).toBe(1)
})
})
npm test # watch 模式,毫秒级热重跑
npm run test:ui # 启动交互式 UI 面板
npm run test:coverage # 一次性跑完 + 生成覆盖率
GitHub Actions 免配置免费跑(公共/私有仓库均可):
# .github/workflows/test.yml
- run: npm ci
- run: npm run test:coverage
📊 8 款前端单测框架横向对比(2026-11)
工具 | 开源协议 | TS 支持 | 速度 | Watch/UI | 覆盖率 | 浏览器模式 | Vite 集成 | 最佳场景 |
|---|---|---|---|---|---|---|---|---|
Vitest | MIT 免费 | ✅ 零配置原生 | ⚡⚡⚡⚡⚡ Vite HMR 级 | ✅ watch + @vitest/ui 免费 | v8 + istanbul 双 Provider | ✅ Playwright 三浏览器(本地免费) | ✅ 原生 | Vite/Vue/React 新项目 |
Jest | MIT 免费 | 需 ts-jest/babel | ⚡⚡ 冷启动慢 | ✅ watch,UI 第三方 | istanbul | ❌ jsdom | 需配置 | 老 React/CRA 项目 |
Playwright Test | Apache-2.0 免费 | ✅ | ⚡⚡⚡⚡ E2E 级 | ✅ Trace/UI | v8 | ✅ 真三浏览器 E2E | 独立 | E2E + 组件测试 |
Cypress | MIT 免费核心 | 需配置 | ⚡⚡ | ✅ GUI 调试 | 需插件 | ✅ 真浏览器 | 需配置 | E2E 为主 |
Mocha + Chai | MIT 免费 | 需 ts-node | ⚡⚡ | ❌ 手动配置 | nyc (istanbul) | ❌ Karma 外挂 | ❌ | 老 Node/通用 |
AVA | MIT 免费 | 需 ts-node | ⚡⚡⚡ 并发 | ❌ | c8/istanbul | ❌ | ❌ | Node 小工具 |
Bun Test | MIT 免费 | ✅ 原生 | ⚡⚡⚡⚡⚡ Bun 最快 | ✅ watch | v8 原生 | ❌ | ❌ | Bun 栈项目 |
Vitest Cloud | 付费 | ✅ | ⚡⚡⚡⚡⚡ + 云并发 | ✅ | 同 | ✅ 云三浏览器并发 | ✅ | 企业跨浏览器云测 |
💰 付费档位参考(可选,不影响核心免费)
档位 | 价格 | 关键能力 |
|---|---|---|
开源免费(核心) | $0 永久 | 本地+自托管CI、Vite原生、v8/istanbul双覆盖率、@vitest/ui、Browser Mode本地、所有框架集成 |
Vitest Cloud Free Tier | $0 | 小团队试用云端 Browser 并发、有限额度 |
Vitest Cloud Pro | 团队定价 | 无限云端并发、跨浏览器云测、SLA、企业 SSO、优先支持 |
说明:核心 Vitest(vitest npm 包)由 MIT 协议永久免费维护,Vitest Cloud 是 StackBlitz 商业化团队推出的增值云服务;任何"Vitest 要收费/闭源"的传言都是把 Cloud 增值服务与核心开源框架混淆。
Vitest 你在项目里用上了吗?是从 Jest 迁过去的,还是新项目直接起?有没有踩过 Browser Mode 或 v8/istanbul 选择的坑?
文 / 壹贰线报 · 开源免费测试工具核实 · 核实时点 2026 年 11 月文中价格与规则以官方文档(vitest.dev)为准