如何在Vitest中所有测试模块前后执行指定函数？

开发者阿泽

2026-8-1

解决方案

方案1：全局 Setup 文件（通用场景）

你可以通过Vitest的setupFiles配置指定一个全局初始化文件，文件内的beforeAll和afterAll会作用于所有测试文件的执行前后：

新建全局setup文件，比如tests/global.setup.ts：

import { beforeAll, afterAll } from 'vitest';

// 所有测试启动前执行一次数据库清理
beforeAll(async () => {
  await clearTestDatabase(); // 替换成你的清理函数
});

// 所有测试结束后执行一次数据库清理
afterAll(async () => {
  await clearTestDatabase();
});

在vitest.config.ts中配置setupFiles：

import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    setupFiles: ['./tests/global.setup.ts'],
    threads: false, // 对应你脚本中的--no-threads
    coverage: {
      // 你的覆盖率相关配置
    }
  }
});

这样不管有多少个.spec.ts测试文件，全局的清理逻辑只会在所有测试开始前和结束后各执行一次。

方案2：全局启动/销毁钩子（Vitest >=0.23.0）

如果你的Vitest版本在0.23.0及以上，可以用globalSetup和globalTeardown配置，这两个钩子在Vitest进程启动/结束时执行，优先级高于测试上下文，适合完全独立的全局操作：

新建全局启动文件tests/global.setup.ts：

export default async function globalSetup() {
  await clearTestDatabase(); // 测试启动前清理数据库
}

新建全局销毁文件tests/global.teardown.ts：

export default async function globalTeardown() {
  await clearTestDatabase(); // 测试结束后清理数据库
}

在vitest.config.ts中配置：

import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    globalSetup: './tests/global.setup.ts',
    globalTeardown: './tests/global.teardown.ts',
    threads: false,
    coverage: {
      // 你的覆盖率相关配置
    }
  }
});