常见错误

Cannot find module './relative-path'

如果你收到一个 module cannot be found 的报错，则可能意味着几种不同情况：

• 1.你拼错了路径。确保路径正确。
• 2.你可能依赖于 tsconfig.json 中的 baseUrl。默认情况下，Vite 不考虑 tsconfig.json，因此如果你依赖此行为，你可能需要自己安装 vite-tsconfig-paths 。

import { defineConfig } from 'vitest/config'
import tsconfigPaths from 'vite-tsconfig-paths'

export default defineConfig({
  plugins: [tsconfigPaths()],
})

或者重写你的路径，使它不是相对于 root。

- import helpers from 'src/helpers'
+ import helpers from '../src/helpers'

• 3. 确保你没有使用相对路径的 别名。Vite 将它们视为相对于导入所在的文件而不是根目录。

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    alias: {
      '@/': './src/', 
      '@/': new URL('./src/', import.meta.url).pathname, 
    },
  },
})

Cannot mock "./mocked-file.js" because it is already loaded

当对已加载的模块调用 vi.mock 方法时，会发生此错误。Vitest 抛出此错误，因为此调用没有效果，因为首选缓存模块。

请记住，vi.mock 总是挂起的 - 这意味着模块在测试文件开始执行之前就已经加载了 - 很可能是在安装文件中。要修复此错误，请删除导入或清除安装文件末尾的缓存 - 请注意，在这种情况下，安装文件和测试文件将引用不同的模块。

// setupFile.js
import { vi } from 'vitest'
import { sideEffect } from './mocked-file.js'

sideEffect()

vi.resetModules()

Failed to terminate worker

当 NodeJS 的 fetch 与默认的 pool: 'threads' 一起使用时，可能会发生此错误。问题可以在 issue#3077 上进行持续更新。

作为解决方法，我们可以切换到 pool: 'forks' 或 pool: 'vmForks'。

在配置文件中指定 pool ：

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    pool: 'forks',
  },
})

或者可以在我们的 package.json 中增加 script ：

scripts: {
-  "test": "vitest"
+  "test": "vitest --pool=forks"
}