Vitest运行时修改文件后测试结果不更新的问题求助

我用Vitest跑测试时遇到了热更新失效的问题——修改代码或测试文件后，控制台看似刷新重跑，但实际没执行更新后的内容：

• 原本5个测试全过，新增第6个测试后，控制台仍显示5/5通过，完全看不到新测试的痕迹
• 修改代码让某个测试明显失败，控制台刷新后结果还是5/5全过
• 只有退出测试runner再重启，才能运行新测试和代码变更，得到正确结果

我的vitest.config.js配置：

import react from '@vitejs/plugin-react';
import { defineConfig } from 'vitest/config'

export default defineConfig({
  plugins: [react()],
  test: {
    include: ['**/*.test.js'],
    globals: true
  },
})

vite.config.js配置：

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  server: {
    port: 3002,
    open: '/index.html',
  },
  resolve: {
      extensions: ['.tsx', '.ts', '.jsx', '.js'], // Include both .tsx and .js extensions
    },
})

当前版本：Vite 5.1.6，Vitest 1.4.0

排查与解决步骤 #

1. 修正测试文件匹配规则 #

你的vitest.config.js中include仅匹配.test.js后缀的文件，如果新增的测试是.jsx/.ts/.tsx格式，会被Vitest忽略。修改规则覆盖所有测试文件后缀：

test: {
  include: ['**/*.test.{js,jsx,ts,tsx}'],
  globals: true
}

2. 禁用测试缓存 #

Vitest的缓存机制可能导致旧模块未被替换，直接禁用缓存或启动时强制不使用缓存：

• 配置文件中禁用：

test: {
  include: ['**/*.test.{js,jsx,ts,tsx}'],
  globals: true,
  cache: false
}

• 启动命令添加参数：

npx vitest --no-cache

3. 升级依赖到稳定版 #

部分版本的Vite/Vitest存在热更新兼容性bug，尝试升级到最新稳定版：

npm update vite vitest

4. 明确文件监听排除规则 #

确保测试文件未被意外排除，显式设置exclude避免干扰：

test: {
  include: ['**/*.test.{js,jsx,ts,tsx}'],
  exclude: ['node_modules', 'dist'],
  globals: true
}

5. 配置正确的测试环境 #

React测试需要jsdom环境，添加该配置可能解决热更新冲突：

test: {
  include: ['**/*.test.{js,jsx,ts,tsx}'],
  globals: true,
  environment: 'jsdom',
  cache: false
}

6. 强制全局监听 #

部分文件系统（如WSL、Docker）存在监听延迟，启动时强制监听所有文件：

npx vitest --watchAll

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