大家好，我遇到一个关于Vitest + TypeScript配置文件的类型检查问题，想请教下怎么解决：

我在vitest.config.ts里写了明显的类型错误（把布尔值赋值给字符串类型变量，再传给Vitest配置的typecheck.enabled），但直接运行npx vitest（交互式/watch模式）时，Vitest完全没提示这个错误，直接就跑测试了；只有当我运行npx vitest run（单次运行模式）时，才会在测试跑完后显示类型错误，而且这个错误放在输出的后面，很容易被忽略。

我希望能在启动Vitest时就立刻检测到配置文件的类型错误，而不是等测试跑完或者只有在非watch模式才提示，请问该怎么调整配置或者流程来实现这个需求？

我的配置与代码 #

vitest.config.ts 代码 #

import { defineConfig } from 'vitest/config'

let boolValue: string = true; // 明显的类型错误：将boolean赋值给string类型变量

export default defineConfig({
  test: {
    typecheck: {
      enabled: boolValue
    },
  })

tsconfig.json 配置 #

{
  "compilerOptions": {
    "module": "nodenext",
    "esModuleInterop": true,
    "allowImportingTsExtensions": true,
    "target": "esnext",
    "types": ["node"],
    // 输出相关配置
    "sourceMap": true,
    "declaration": true,
    "declarationMap": true,
    // 严格类型检查选项
    "noUncheckedIndexedAccess": true,
    "exactOptionalPropertyTypes": true,
    // 推荐选项
    "strict": true,
    "verbatimModuleSyntax": true,
    "isolatedModules": true,
    "noUncheckedSideEffectImports": true,
    "moduleDetection": "force",
    "skipLibCheck": true,
  }
}

实际现象 #

• 运行 npx vitest（watch模式）：直接进入测试流程，全程无任何类型错误提示，仿佛配置文件完全正常
• 运行 npx vitest run（单次运行）：测试跑完后，才会在输出末尾显示类型错误，内容如下：

⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯ Unhandled Source Error ⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
TypeCheckError: No overload matches this call. The last overload gave the following error.
Type 'string' is not assignable to type 'boolean | undefined'.
❯ vitest.config.ts:6:7

我的核心疑问是：为什么Vitest在watch模式下默认不检测配置文件的类型错误？有没有办法让它在启动时就先检查配置文件的类型，有错误就直接终止，不要跑测试？

可行的解决方案 #

1. 配置Vitest内置的configFileCheck选项（推荐） #

Vitest v0.30+版本新增了configFileCheck配置项，可以强制在启动前检查配置文件的有效性（包括类型）。只需要在vitest.config.ts中添加该配置：

import { defineConfig } from 'vitest/config'

export default defineConfig({
  // 强制在启动前检查配置文件，有错误直接终止
  configFileCheck: 'error',
  test: {
    typecheck: {
      enabled: true
    },
  }
})

这个选项的可选值：

• 'warn'：仅弹出警告，不终止启动
• 'error'：检测到错误直接终止启动，不执行测试
• 'off'：关闭检查（默认值）

设置为'error'后，不管是watch模式还是单次运行模式，Vitest都会先检查配置文件的类型，有错误立刻报错退出，不会继续执行测试。

2. 添加前置类型检查脚本 #

在package.json中添加一个组合脚本，先对配置文件做类型检查，再启动Vitest：

{
  "scripts": {
    "test": "tsc --noEmit vitest.config.ts && vitest",
    "test:run": "tsc --noEmit vitest.config.ts && vitest run"
  }
}

这样每次运行npm run test时，会先执行tsc --noEmit vitest.config.ts检查配置文件的类型，有错误就直接终止；只有配置文件类型正确时，才会进入Vitest的测试环节。

3. 利用IDE实时检测 #

在VSCode这类支持TypeScript的IDE中，只要正确配置了TS环境，应该能实时看到vitest.config.ts里的类型错误，不用等运行时才发现。可以检查下IDE的TypeScript服务是否正常加载了Vitest的类型定义，确保@vitest/config的类型被正确识别。

补充说明 #

Vitest的watch模式默认会优先快速启动测试流程，把配置文件的类型检查后置了；而vitest run作为单次运行模式，会在所有流程结束后汇总包括配置文件在内的所有错误。通过上面的方法可以把配置文件的检查提前，避免遗漏类型错误。