Vue3默认项目中tsconfig.vitest.json的使用场景是什么？

这个文件是专门为测试场景下的类型检查定制的TypeScript配置，和vitest.config.ts是互补关系——前者管TypeScript类型规则，后者管Vitest的测试运行逻辑，并非替代关系。

核心使用场景 #

• 执行全量类型检查时
  你看到的package.json里的type-check脚本，就是专门用这个配置来做项目全量类型校验的。默认的tsconfig.json通常会排除test目录，而tsconfig.vitest.json会把测试文件纳入检查范围，同时配置了适配测试的类型规则（比如允许使用Vitest的全局API如describe、test）。
  脚本里的参数作用：

  • --noEmit：只做类型检查，不生成编译后的代码
  • -p tsconfig.vitest.json：明确指定使用这个配置文件
  • --composite false：关闭增量编译，确保单次检查的结果是最新、准确的

• Vitest运行测试时
  虽然vitest.config.ts是测试的核心配置，但Vitest在处理测试文件的类型时，会自动读取tsconfig.vitest.json，保证测试代码的类型校验规则和项目主代码对齐，同时兼容测试特有的语法和API，避免出现不必要的类型报错。

触发条件 #

• 手动执行命令：npm run type-check，脚本会直接指定加载该配置
• 运行单元测试：执行npm run test:unit（或其他Vitest相关命令）时，Vitest会自动识别并使用该配置处理测试文件的类型环境

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