Vitest 免费版线报:Vite 原生单元测试框架,MIT 开源永久免费

壹贰线报 · 开源免费测试工具核实

核实时点: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 个细节(以官方文档为准)

  1. 核心 MIT 永久免费,"Vitest Cloud"是附加付费服务——Vitest 本地运行、npm 安装、CI(GitHub Actions/GitLab CI/自建 Docker)全部 0 成本;付费的是 StackBlitz 收购后推出的 Vitest Cloud(Browser 模式云端并发、跨浏览器云测、企业 SSO),不影响本地+自托管全功能免费。

  2. v8 覆盖率自 v3.2.0 起精度对齐 Istanbul——默认走 v8 覆盖(@vitest/coverage-v8)无需预插桩速度快;Firefox/Bun/Cloudflare Workers 这类非 V8 环境用 @vitest/coverage-istanbul(预插桩+全环境兼容),两套报告精度自 v3.2.0 起一致。

  3. Browser Mode 是 Vitest 3.x 杀手级能力——直接在真实浏览器(Chrome/Firefox/WebKit via Playwright)里跑单元测试,告别 jsdom 误判;@vitest/browser 本地免费无限量,云并发才走 Vitest Cloud 付费。


🎁 两个隐藏福利

  1. @vitest/ui 交互式 UI 完全免费——npx vitest --ui 启动图形化面板,实时过滤、重跑、源码定位、覆盖率热图,比 Jest 的 jest --watchAll 体验好一个数量级;

  2. 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

@vitest/ui 免费(npx vitest --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 插件

官方 Vitest 插件免费(测试资源管理器+inline gutter 状态)

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


⚠️ 三个注意事项

  1. Node 版本最低 18+,推荐 20/22 LTS——Vitest 3.x 依赖 Vite 6/7 与 ESM,Node 16 已不支持;老项目先升 Node。

  2. CommonJS 模块需配置——Vitest 走 ESM 原生,老的 CJS 包(如 enzyme、部分 axios 旧版)通过 vite.config 的 ssr.noExternal / test.server.deps.inline 处理。

  3. 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)为准


版权声明

本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。