Vitest单测试文件运行耗时过长问题排查与解决

问题场景 #

项目目录结构：

-frontend
  -src
     -components
        -__test__
     -pages
     -dialogs
     - etc

__test__目录下存放组件对应的测试用例（如Editor.test.jsx）。执行命令 npx vitest run .\src\components\__test__\EditMenuForNotes.test.jsx 运行单个测试文件时，测试本身仅耗时124ms，但collect阶段耗时长达72.86秒，完整输出如下：

src/components/__test__/EditMenuForNotes.test.jsx (1 test) 126ms
   ✓ Edit Menu For Notes > renders delete, favorite, and pin icons with correct tooltips 124ms

 Test Files  1 passed (1)
      Tests  1 passed (1)
   Start at  01:37:07
   Duration  74.78s (transform 24.11s, setup 0ms, collect 72.86s, tests 126ms, environment 1.19s, prepare 214ms)

可能原因 #

• Vitest默认扫描逻辑冗余：即使指定单个文件，Vitest仍会默认遍历整个项目目录，匹配所有符合全局规则的测试文件，导致collect阶段扫描大量非目标文件，耗时剧增。
• 代码覆盖率收集拖慢速度：如果运行测试时默认开启了代码覆盖率，collect阶段会额外扫描全量文件生成覆盖率数据，这是耗时的核心原因之一。
• 依赖解析负载过高：测试文件依赖的组件引入了大量深层依赖，collect阶段需要递归解析所有关联模块，加上未启用缓存或缓存失效，进一步拉长时间。
• 配置文件匹配规则宽泛：vite.config.js或vitest.config.js中配置了如**/__test__/**这类全局测试匹配规则，即使指定单个文件，Vitest仍会先扫描所有符合规则的文件再过滤，额外增加扫描成本。

解决方法 #

• 关闭覆盖率收集：添加--no-coverage参数跳过覆盖率扫描，直接缩短collect阶段耗时：

  npx vitest run --no-coverage .\src\components\__test__\EditMenuForNotes.test.jsx
  

• 精确限制扫描范围：使用--include参数强制Vitest只处理指定文件，避免全局遍历：

  npx vitest run --include .\src\components\__test__\EditMenuForNotes.test.jsx
  

  也可以临时在配置文件中缩小匹配范围：

  export default defineConfig({
    test: {
      include: ['.\\src\\components\\__test__\\EditMenuForNotes.test.jsx']
    }
  })
  

• 清理并启用模块缓存：检查Vitest配置中cache: true是否开启，若缓存异常，手动删除node_modules/.vitest目录后重新运行，减少重复解析模块的时间。
• 精简测试依赖：检查测试文件，移除不必要的全局依赖或大型组件引入，只保留测试必需的最小依赖集合，降低collect阶段的解析负载。

内容的提问来源于stack exchange，提问作者Muhammad Ahsan