Node TypeScript 项目构建后测试文件重复执行问题分析

在Node.js与TypeScript结合的项目开发中，我们经常会遇到一个典型问题：当项目构建后运行测试时，Vitest测试框架会同时执行源代码目录和构建输出目录中的测试文件，导致测试结果重复计数。这个问题在jsynowiec/node-typescript-boilerplate项目中得到了重现和解决。

问题现象

当开发者执行标准构建流程后运行测试时，会观察到以下现象：

1. 构建过程将TypeScript测试文件(.test.ts)转译为JavaScript测试文件(.test.js)并输出到build目录
2. 运行测试时，Vitest同时执行了原始TypeScript测试文件和构建后的JavaScript测试文件
3. 测试结果中显示每个测试用例被重复执行，测试计数翻倍

问题根源

这个问题的根本原因在于Vitest默认配置会扫描项目目录下的所有测试文件，而没有自动排除构建输出目录。在TypeScript项目中，构建过程会将测试文件一同转译到输出目录（如build/），导致：

1. 源代码目录中的原始测试文件（如__tests__/unit/*.test.ts）
2. 构建输出目录中的转译后测试文件（如build/tests/unit/*.test.js）

两者都会被Vitest发现并执行。

解决方案

针对这个问题，项目维护者提供了两种解决方案：

1. 使用专用构建命令：推荐使用npm run build:release命令进行构建，这个构建配置通常会排除测试文件，避免它们被转译到输出目录。

2. 配置Vitest排除规则：在Vitest配置文件中显式排除构建输出目录，可以通过修改vite.config.ts或vitest.config.ts文件，添加以下配置：

test: {
  exclude: ['build/**']
}

最佳实践建议

对于TypeScript项目的测试配置，建议开发者：

1. 明确区分开发环境测试和生产环境构建
2. 为不同环境设置不同的构建配置
3. 在持续集成流程中，根据场景选择适当的构建和测试命令
4. 考虑将测试文件与源代码分离存放，便于构建配置管理

通过合理配置构建和测试流程，可以避免测试重复执行的问题，确保开发体验和测试结果的准确性。