迁移指南

迁移到 Vitest 4.0

V8 Code Coverage Major Changes

Vitest 的 V8 覆盖率提供器现在使用了更精准的结果映射逻辑，从 Vitest v3 升级后，你可能会看到覆盖率报告的内容有变化。

之前 Vitest 使用 v8-to-istanbul 将 V8 覆盖率结果映射到源码文件，但这种方式不够准确，报告中常常会出现误报。现在我们开发了基于 AST 分析的新方法，使 V8 报告的准确度与 @vitest/coverage-istanbul 一致。

覆盖率忽略提示已更新，详见覆盖率 | 忽略代码。
已移除 coverage.ignoreEmptyLines 选项。没有可执行代码的行将不再出现在报告中。
已移除 coverage.experimentalAstAwareRemapping 选项。此功能现已默认启用，并成为唯一的映射方式。
现在 V8 提供器也支持 coverage.ignoreClassMethods。

移除 `coverage.all` 和 `coverage.extensions` 选项

在之前的版本中，Vitest 会默认把所有未覆盖的文件包含到报告中。这是因为 coverage.all 默认为 true，coverage.include 默认为 **。这样设计是因为测试工具无法准确判断用户源码所在位置。

然而，这导致 Vitest 覆盖率工具会处理很多意料之外的文件（例如压缩 JS 文件），造成报告生成速度很慢甚至卡死。在 Vitest v4 中，我们彻底移除了 coverage.all，并将默认行为改为只在报告中包含被测试覆盖的文件。

升级至 v4 版本时，建议先在配置文件中定义 coverage.include，再根据需要逐步添加简单的 coverage.exclude 匹配规则。

vitest.config.ts

export default defineConfig({
  test: {
    coverage: {
      // 包含匹配此模式的被覆盖和未覆盖文件：
      include: ['packages/**/src/**.{js,jsx,ts,tsx}'], 

      // 对上述 include 匹配到的文件应用排除规则：
      exclude: ['**/some-pattern/**'], 

      // 以下选项已移除
      all: true, 
      extensions: ['js', 'ts'], 
    }
  }
})

如果未定义 coverage.include，报告将只包含测试运行中被加载的文件：

vitest.config.ts

export default defineConfig({
  test: {
    coverage: {
      // 未设置 include，只包含运行时加载的文件
      include: undefined, 

      // 匹配此模式的已加载文件将被排除：
      exclude: ['**/some-pattern/**'], 
    }
  }
})

更多示例请参考：

覆盖率报告中的文件包含与排除
性能分析 | 代码覆盖率了解调试覆盖率生成的方法

简化的 `exclude` 配置

默认情况下，Vitest 现在仅排除 node_modules 和 .git 文件夹中的测试文件。这意味着 Vitest 不再排除以下内容：

dist 和 cypress 文件夹
.idea、.cache、.output、.temp 文件夹
配置文件，如 rollup.config.js、prettier.config.js、ava.config.js 等

如果需要限制测试文件所在的目录，建议使用 test.dir 选项，因为它的性能优于排除文件：

import { configDefaults, defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    dir: './frontend/tests', 
  },
})

要恢复之前的行为，请手动指定旧的 excludes：

import { configDefaults, defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    exclude: [
      ...configDefaults.exclude,
      '**/dist/**', 
      '**/cypress/**', 
      '**/.{idea,git,cache,output,temp}/**', 
      '**/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*'
    ],
  },
})

`spyOn` 和 `fn` 支持构造函数

在之前的版本中，如果尝试使用 vi.spyOn 监视构造函数，可能会收到类似 Constructor <name> requires 'new' 的错误。自 Vitest 4 起，所有通过 new 关键字调用的模拟会构造实例，而不是调用 mock.apply。这意味着在这些情况下，模拟实现必须使用 function 或 class 关键字：

const cart = {
  Apples: class Apples {
    getApples() {
      return 42
    }
  }
}

const Spy = vi.spyOn(cart, 'Apples')
  .mockImplementation(() => ({ getApples: () => 0 })) 
  // 使用 function 关键字
  .mockImplementation(function () {
    this.getApples = () => 0
  })
  // 使用自定义 class
  .mockImplementation(class MockApples {
    getApples() {
      return 0
    }
  })

const mock = new Spy()

请注意，如果此时使用箭头函数，调用 mock 时会报 <anonymous> is not a constructor 错误。

Mock 的变更

除了新增对构造函数的支持等功能外，Vitest 4 还对模拟的创建方式进行了调整，以解决多年来我们收到的多个模块模拟问题。此版本试图减少模块监视的混淆，尤其是在处理类时。

vi.fn().getMockName() 现在默认返回 vi.fn() 而非 spy。这可能会影响包含模拟的快照 —— 名称将从 [MockFunction spy] 改为 [MockFunction]。通过 vi.spyOn 创建的监视器默认仍会使用原始名称，以提供更好的调试体验。
vi.restoreAllMocks 不再重置监视器的状态，仅恢复通过 vi.spyOn 手动创建的监视器，自动模拟不再受此函数影响（这也影响了配置选项 restoreMocks）。需注意的是，.mockRestore 仍会重置模拟实现并清除状态。
对模拟调用 vi.spyOn 现在会返回相同的模拟。
mock.settledResults 现在会在函数调用时立即填充一个 'incomplete' 结果。当 Promise 完成时，类型会根据结果更新。
自动模拟的实例方法现在已正确隔离，但仍与原型共享状态。除非实例方法有自己的自定义模拟实现，否则覆盖原型实现将始终影响实例方法。对模拟调用 .mockReset 也不再破坏这种继承关系。

import { AutoMockedClass } from './example.js'
const instance1 = new AutoMockedClass()
const instance2 = new AutoMockedClass()

instance1.method.mockReturnValue(42)

expect(instance1.method()).toBe(42)
expect(instance2.method()).toBe(undefined)

expect(AutoMockedClass.prototype.method).toHaveBeenCalledTimes(2)

instance1.method.mockReset()
AutoMockedClass.prototype.method.mockReturnValue(100)

expect(instance1.method()).toBe(100)
expect(instance2.method()).toBe(100)

expect(AutoMockedClass.prototype.method).toHaveBeenCalledTimes(4)

自动 mock 方法一经生成即不可还原，手动 .mockRestore 无效；spy: true 的自动 mock 模块行为保持不变。
自动 mock 的 getter 不再执行原始逻辑，默认返回 undefined；如需继续监听并改写，请使用 vi.spyOn(object, name, 'get')。
执行 vi.fn(implementation).mockReset() 后，.getMockImplementation() 现可正确返回原 mock 实现。
vi.fn().mock.invocationCallOrder 现以 1 起始，与 Jest 保持一致。

带文件名过滤器的独立模式

为了提升用户体验，当 --standalone 与文件名过滤器一起使用时，Vitest 现在会直接开始运行匹配到的文件。

# 在 Vitest v3 及以下版本中，该命令将忽略 "math.test.ts" 文件名过滤器。
# 在 Vitest v4 中，math.test.ts 将自动运行。
$ vitest --standalone math.test.ts

这允许用户为独立模式创建可复用的 package.json。

package.jsonCLI

json

{
  "scripts": {
    "test:dev": "vitest --standalone"
  }
}

bash

# 以独立模式启动 Vitest，启动时不运行任何文件
$ pnpm run test:dev

# 立即运行 math.test.ts
$ pnpm run test:dev math.test.ts

`vite-node` 替换为 Module Runner

Module Runner 已取代 vite-node，直接内嵌于 Vite, Vitest 亦移除 SSR 封装，直接调用。主要变更如下：

VITE_NODE_DEPS_MODULE_DIRECTORIES 环境变量已替换为 VITEST_MODULE_DIRECTORIES
Vitest 不再向每个测试运行器注入 __vitest_executor，改为注入 moduleRunner，它是 ModuleRunner 的实例
vitest/execute 入口点已移除，它始终仅供内部使用
自定义环境不再需要提供 transformMode 属性，改为提供 viteEnvironment。若未提供，Vitest 将使用环境名称在服务端转换文件（更多内容请参阅 server.environments）
vite-node 不再是 Vitest 的依赖项
deps.optimizer.web 已重命名为 deps.optimizer.client。在使用其他服务端环境时，你也可以使用任意自定义名称来应用优化器配置

Vite 已提供外部化机制，但为降低破坏性，仍保留旧方案；server.deps 可继续用于包的内联/外部化。

未使用上述高级功能者，升级无感知。

`workspace` 替换为 `projects`

在 Vitest 3.2 中，workspace 配置选项更名为 projects。除了不能指定其他文件作为工作区的源文件（以前可以指定导出项目数组的文件）外，它们在功能上是相同的。迁移到 projects 非常简单，只需将代码从 vitest.workspace.js 移动到 vitest.config.ts：

vitest.config.jsvitest.workspace.js

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    workspace: './vitest.workspace.js', 
    projects: [ 
      './packages/*', 
      { 
        test: { 
          name: 'unit', 
        }, 
      }, 
    ] 
  }
})

import { defineWorkspace } from 'vitest/config'

export default defineWorkspace([ 
  './packages/*', 
  { 
    test: { 
      name: 'unit', 
    }, 
  } 
])

修改浏览器模式提供者

在 Vitest 4.0 中，浏览器提供者现在接受对象而非字符 ('playwright', 'webdriverio')。 preview 不再是默认设置。这使得使用自定义选项变得更简单，而且不再需要添加 /// <reference 注释。

import { playwright } from '@vitest/browser-playwright'

export default defineConfig({
  test: {
    browser: {
      provider: 'playwright', 
      provider: playwright({ 
        launchOptions: { 
          slowMo: 100, 
        }, 
      }), 
      instances: [
        {
          browser: 'chromium',
          launch: { 
            slowMo: 100, 
          }, 
        },
      ],
    },
  },
})

现在，playwright 工厂中的属性命名也与 Playwright 文档一致，从而更容易查找。

有了这一变更，就不再需要 @vitest/browser 软件包了，您可以将其从依赖关系中移除。要支持上下文导入，应将 @vitest/browser/context 更新为 vitest/browser：

import { page } from '@vitest/browser/context'
import { page } from 'vitest/browser'

test('example', async () => {
  await page.getByRole('button').click()
})

这些模块完全相同，因此只需进行简单的 “查找和替换” 即可。

如果使用 @vitest/browser/utils 模块，现在也可以从 vitest/browser 导入这些实用程序：

import { getElementError } from '@vitest/browser/utils'
import { utils } from 'vitest/browser'
const { getElementError } = utils

WARNING

在过渡期间，@vitest/browser/context 和 @vitest/browser/utils 都能在运行时工作，但它们将在未来的版本中移除。

Pool 重构

Vitest 过去使用 tinypool 来编排测试文件在 test runner worker 中的运行方式。Tinypool 负责在内部处理并行、隔离和 IPC 通信等复杂任务。然而我们发现 Tinypool 存在一些缺陷，拖慢了 Vitest 的开发进度。在 Vitest v4 中，我们彻底移除了 Tinypool，并在不引入新依赖的前提下重写了 pool 的工作机制。详细原因请参阅 feat!: rewrite pools without tinypool #8705

新的 pool 架构使 Vitest 得以简化许多此前复杂的配置项：

maxThreads 和 maxForks 现统一为 maxWorkers。
环境变量 VITEST_MAX_THREADS 和 VITEST_MAX_FORKS 现统一为 VITEST_MAX_WORKERS。
singleThread 和 singleFork 现等价于 maxWorkers: 1, isolate: false。如果你的测试依赖测试间的模块重置，需添加 setupFile 并在 beforeAll 测试钩子中调用 vi.resetModules()。
poolOptions 已移除。原有的所有 poolOptions 配置项现均为顶层选项。虚拟运行池的 memoryLimit 已重命名为 vmMemoryLimit。
threads.useAtomics 已移除。如果你有相关使用场景，欢迎提交新的功能请求。
自定义运行池接口已重写，详见自定义运行池。

export default defineConfig({
  test: {
    poolOptions: { 
      forks: { 
        execArgv: ['--expose-gc'], 
        isolate: false, 
        singleFork: true, 
      }, 
      vmThreads: { 
        memoryLimit: '300Mb'
      }, 
    }, 
    execArgv: ['--expose-gc'], 
    isolate: false, 
    maxWorkers: 1, 
    vmMemoryLimit: '300Mb', 
  }
})

此前在使用测试项目时，无法为单个项目单独指定某些 pool 相关配置项。新架构已解除了这一限制。

按项目隔离并行与串行项目按项目分配 Node CLI 选项

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    projects: [
      {
        // 非隔离的单元测试
        name: 'Unit tests',
        isolate: false,
        exclude: ['**.integration.test.ts'],
      },
      {
        // 隔离的集成测试
        name: 'Integration tests',
        include: ['**.integration.test.ts'],
      },
    ],
  },
})

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    projects: [
      {
        name: 'Parallel',
        exclude: ['**.sequential.test.ts'],
      },
      {
        name: 'Sequential',
        include: ['**.sequential.test.ts'],
        fileParallelism: false,
      },
    ],
  },
})

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    projects: [
      {
        name: 'Production env',
        execArgv: ['--env-file=.env.prod']
      },
      {
        name: 'Staging env',
        execArgv: ['--env-file=.env.staging']
      },
    ],
  },
})

更多示例请参阅测试技巧。

报告器升级

Reporter API 中的 onCollected、onSpecsCollected、onPathsCollected、onTaskUpdate 和 onFinished 已被移除。新的替代方案请参阅 Reporters API。新 API 于 Vitest v3.0.0 中引入。

移除了 basic 报告器，因为它等价于：

export default defineConfig({
  test: {
    reporters: [
      ['default', { summary: false }]
    ]
  }
})

现在，verbose 报告器会以平面列表的形式打印测试用例。要恢复以前的行为，请使用 --reporter=tree:

export default defineConfig({
  test: {
    reporters: ['verbose'], 
    reporters: ['tree'], 
  }
})

使用自定义元素打印 Shadow Root 快照

在 Vitest 4.0 中，包含自定义元素的快照将打印阴影根内容。要恢复以前的行为，请将 printShadowRoot option 设为false。

// 自 Vitest 4.0 前
exports[`custom element with shadow root 1`] = `
"<body>
  <div>
    <custom-element />
  </div>
</body>"
`

// 自 Vitest 4.0 后
exports[`custom element with shadow root 1`] = `
"<body>
  <div>
    <custom-element>
      #shadow-root
        <span
          class="some-name"
          data-test-id="33"
          id="5"
        >
          hello
        </span>
    </custom-element>
  </div>
</body>"
`

移除弃用的 API

Vitest 4.0 移除了以下废弃的配置项：

poolMatchGlobs 配置项。请使用 projects 代替。
environmentMatchGlobs 配置项。请使用 projects 代替。
deps.external、deps.inline、deps.fallbackCJS 配置项。请改用 server.deps.external、server.deps.inline 或 server.deps.fallbackCJS。
browser.testerScripts 配置项。请使用 browser.testerHtmlPath 代替。
minWorkers 配置项。只有 maxWorkers 会对测试运行方式产生影响，因此我们正在移除这个公共选项。
Vitest 不再支持将测试选项作为第三个参数提供给 test 和 describe。请改用第二个参数。

test('example', () => { /* ... */ }, { retry: 2 }) 
test('example', { retry: 2 }, () => { /* ... */ })

Note that providing a timeout number as the last argument is still supported:

test('example', () => { /* ... */ }, 1000) // ✅

This release also removes all deprecated types. This finally fixes an issue where Vitest accidentally pulled in @types/node (see #5481 and #6141).

从 Jest 迁移

Vitest 的 API 设计兼容 Jest，旨在使从 Jest 迁移尽可能简单。尽管如此，你仍可能遇到以下差异：

默认是否启用全局变量

Jest 默认启用其 globals API。Vitest 默认不启用。你可以通过配置项 globals 启用全局变量，或者修改代码直接从 vitest 模块导入所需 API。

如果选择不启用全局变量，注意常用库如 testing-library 将不会自动执行 DOM 的清理。

`mock.mockReset`

Jest 的 mockReset 会将 mock 实现替换为空函数，返回 undefined。

Vitest 的 mockReset 会将 mock 实现重置为最初的实现。也就是说，使用 vi.fn(impl) 创建的 mock，mockReset 会将实现重置为 impl。

`mock.mock` 是持久的

Jest 调用 .mockClear 后会重建 mock 状态，只能以 getter 方式访问； Vitest 则保留持久引用，可直接复用。

const mock = vi.fn()
const state = mock.mock
mock.mockClear()

expect(state).toBe(mock.mock) // 在 Jest 中失败

模块 Mock

在 Jest 中，mock 模块时工厂函数返回值即为默认导出。在 Vitest 中，工厂函数需返回包含所有导出的对象。例如，以下 Jest 代码需要改写为：

jest.mock('./some-path', () => 'hello') 
vi.mock('./some-path', () => ({ 
  default: 'hello', 
}))

更多细节请参考 vi.mock API。

自动 Mock 行为

与 Jest 不同，Vitest 仅在调用 vi.mock() 时加载 <root>/__mocks__ 中的模块。如果你需要像 Jest 一样在每个测试中自动 mock，可以在 setupFiles 中调用 mock。

导入被 Mock 包的原始模块

如果只部分 mock 一个包，之前可能用 Jest 的 requireActual，Vitest 中应使用 vi.importActual：

const { cloneDeep } = jest.requireActual('lodash/cloneDeep') 
const { cloneDeep } = await vi.importActual('lodash/cloneDeep')

扩展 Mock 到外部库

Jest 默认会扩展 mock 到使用相同模块的外部库。Vitest 需要显式告知要 mock 的第三方库，使其成为源码的一部分，方法是使用 server.deps.inline：

server.deps.inline: ["lib-name"]

`expect.getState().currentTestName`

Vitest 的测试名使用 > 符号连接，方便区分测试与套件，而 Jest 使用空格 ()。

diff

- `${describeTitle} ${testTitle}`
+ `${describeTitle} > ${testTitle}`

环境变量

与 Jest 一样，如果 NODE_ENV 在此之前未被设置，Vitest 会将其设为 test。Vitest 还提供了与 JEST_WORKER_ID 对应的 VITEST_POOL_ID（始终小于或等于 maxWorkers），如果你依赖该变量，别忘了重命名。Vitest 还暴露了 VITEST_WORKER_ID，它是运行中 worker 的唯一 ID 且该编号不受 maxWorkers 影响，每创建一个新 worker 就会递增。

替换属性

如果想修改对象，Jest 使用 replaceProperty API，Vitest 可使用 vi.stubEnv 或 vi.spyOn 达成相同效果。

Done 回调

Vitest 不支持回调式测试声明。你可以改写为使用 async/await 函数，或使用 Promise 来模拟回调风格。

it('should work', (done) => {  
it('should work', () => new Promise(done => { 
  // ...
  done()
}) 
}))

Hooks

Vitest 中 beforeAll/beforeEach 钩子可返回清理函数。因此，如果钩子返回非 undefined 或 null，可能需改写：

beforeEach(() => setActivePinia(createTestingPinia())) 
beforeEach(() => { setActivePinia(createTestingPinia()) })

在 Jest 中钩子是顺序执行的（一个接一个）。默认情况下，Vitest 在栈中运行钩子。要使用 Jest 的行为，请更新 sequence.hooks 选项：

export default defineConfig({
  test: {
    sequence: { 
      hooks: 'list', 
    } 
  }
})

类型

Vitest 没有 Jest 的 jest 命名空间，需直接从 vitest 导入类型：

let fn: jest.Mock<(name: string) => number> 
import type { Mock } from 'vitest'
let fn: Mock<(name: string) => number>

定时器

Vitest 不支持 Jest 的遗留定时器。

超时

如果使用了 jest.setTimeout，需迁移为 vi.setConfig：

jest.setTimeout(5_000) 
vi.setConfig({ testTimeout: 5_000 })

Vue 快照

这不是 Jest 特有的功能，但如果你之前在 vue-cli 预设中使用 Jest，你需要安装 jest-serializer-vue 包，并在 snapshotSerializers 中指定它：

vitest.config.js

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    snapshotSerializers: ['jest-serializer-vue']
  }
})

否则快照中会出现大量转义的 " 字符。

从 Mocha + Chai + Sinon 迁移

Vitest 对从 Mocha+Chai+Sinon 测试套件迁移提供了完善支持。虽然 Vitest 默认使用与 Jest 兼容的 API，但它同时也提供 Chai 风格的断言用于 spy/mock 测试，从而降低迁移成本。

测试结构

Mocha 与 Vitest 的测试结构相似，但存在一些差异：

// Mocha
describe('suite', () => {
  before(() => { /* 初始化 */ })
  after(() => { /* 清理 */ })
  beforeEach(() => { /* 初始化 */ })
  afterEach(() => { /* 清理 */ })

  it('test', () => {
    // 测试代码
  })
})

// Vitest - 相同的结构同样适用！
import { afterAll, afterEach, beforeAll, beforeEach, describe, it } from 'vitest'

describe('suite', () => {
  beforeAll(() => { /* 初始化 */ })
  afterAll(() => { /* 清理 */ })
  beforeEach(() => { /* 初始化 */ })
  afterEach(() => { /* 清理 */ })

  it('test', () => {
    // 测试代码
  })
})

断言

Vitest 默认内置 Chai 断言，因此 Chai 断言无需任何修改即可使用：

// Mocha+Chai 与 Vitest 均适用
import { expect } from 'vitest' // 或在 Mocha 中导入 'chai'

expect(value).to.equal(42)
expect(value).to.be.true
expect(array).to.have.lengthOf(3)
expect(obj).to.have.property('key')

Spy/Mock 断言

Vitest 为 spy 和 mock 提供 Chai 风格 的断言，让你无需重写断言即可从 Sinon 迁移：

// 迁移前（Mocha + Chai + Sinon）
const sinon = require('sinon')
const chai = require('chai')
const sinonChai = require('sinon-chai')
chai.use(sinonChai)

const spy = sinon.spy(obj, 'method')
obj.method('arg1', 'arg2')

expect(spy).to.have.been.called
expect(spy).to.have.been.calledOnce
expect(spy).to.have.been.calledWith('arg1', 'arg2')

// 迁移后（Vitest）- 断言语法完全相同！
import { expect, vi } from 'vitest'

const spy = vi.spyOn(obj, 'method')
obj.method('arg1', 'arg2')

expect(spy).to.have.been.called
expect(spy).to.have.been.calledOnce
expect(spy).to.have.been.calledWith('arg1', 'arg2')

完整的 Chai 风格断言支持

Vitest supports all common sinon-chai assertions:

Sinon-Chai	Vitest	详情
`spy.called`	`called`	Spy 至少被调用过一次
`spy.calledOnce`	`calledOnce`	Spy 恰好被调用过一次
`spy.calledTwice`	`calledTwice`	Spy 恰好被调用过两次
`spy.calledThrice`	`calledThrice`	Spy 恰好被调用过三次
`spy.callCount(n)`	`callCount(n)`	Spy 被调用过 n 次
`spy.calledWith(...)`	`calledWith(...)`	Spy 以特定参数被调用
`spy.calledOnceWith(...)`	`calledOnceWith(...)`	Spy 以特定参数恰好被调用一次
`spy.returned`	`returned`	Spy 成功返回
`spy.returnedWith(value)`	`returnedWith(value)`	Spy 返回了特定值

更多内容请参阅 Chai 风格 Spy 断言文档中的完整列表。

创建 Spy 和 Mock

用 Vitest 的 vi 工具替换 Sinon 的 spy/stub/mock 创建方式：

// Sinon
const sinon = require('sinon')
const spy = sinon.spy()
const stub = sinon.stub(obj, 'method')
const mock = sinon.mock(obj)

// Vitest
import { vi } from 'vitest'
const spy = vi.fn()
const stub = vi.spyOn(obj, 'method')
// Vitest 没有 "mock" 的概念，请使用 spy 代替

存根返回值

// Sinon
stub.returns(42)
stub.onFirstCall().returns(1)
stub.onSecondCall().returns(2)

// Vitest
stub.mockReturnValue(42)
stub.mockReturnValueOnce(1)
stub.mockReturnValueOnce(2)

存根实现

// Sinon
stub.callsFake(arg => arg * 2)

// Vitest
stub.mockImplementation(arg => arg * 2)

恢复 Spy

// Sinon
spy.restore()
sinon.restore() // 恢复全部

// Vitest
spy.mockRestore()
vi.restoreAllMocks() // 恢复全部

定时器

Sinon 和 Vitest 在内部都使用 @sinonjs/fake-timers：

// Sinon
const clock = sinon.useFakeTimers()
clock.tick(1000)
clock.restore()

// Vitest
import { vi } from 'vitest'
vi.useFakeTimers()
vi.advanceTimersByTime(1000)
vi.useRealTimers()

主要差异

全局变量：Mocha 默认提供全局变量。在 Vitest 中，需要从 vitest 导入，或启用 globals 配置。
断言风格：可同时使用 Chai 风格（expect(spy).to.have.been.called）和 Jest 风格（expect(spy).toHaveBeenCalled()）。
并发执行：Vitest 默认并发运行测试，Mocha 则顺序执行。

更多内容请参阅：

迁移指南 ​

迁移到 Vitest 4.0 ​

V8 Code Coverage Major Changes ​

移除 coverage.all 和 coverage.extensions 选项 ​

简化的 exclude 配置 ​

spyOn 和 fn 支持构造函数 ​

Mock 的变更 ​

带文件名过滤器的独立模式 ​

vite-node 替换为 Module Runner ​

workspace 替换为 projects ​

修改浏览器模式提供者 ​

Pool 重构 ​

报告器升级 ​

使用自定义元素打印 Shadow Root 快照 ​

移除弃用的 API ​

从 Jest 迁移 ​

默认是否启用全局变量 ​

mock.mockReset ​

mock.mock 是持久的 ​

模块 Mock ​

自动 Mock 行为 ​

导入被 Mock 包的原始模块 ​

扩展 Mock 到外部库 ​

expect.getState().currentTestName ​

环境变量 ​

替换属性 ​

Done 回调 ​

Hooks ​

类型 ​

定时器 ​

超时 ​

Vue 快照 ​

从 Mocha + Chai + Sinon 迁移 ​

测试结构 ​

断言 ​

Spy/Mock 断言 ​

完整的 Chai 风格断言支持 ​

创建 Spy 和 Mock ​

存根返回值 ​

存根实现 ​

恢复 Spy ​