Knip项目中Vitest插件对`.mts`扩展名的支持问题解析

背景介绍

Knip是一个用于JavaScript和TypeScript项目的依赖分析和死代码检测工具。它通过插件系统支持各种测试框架，其中就包括流行的Vitest测试框架。在项目配置方面，Vitest支持多种文件扩展名，包括.ts、.js、.json以及较新的.mts和.cts等模块化TypeScript扩展名。

问题发现

在Knip的Vitest插件实现中，开发团队最初只匹配了.ts、.js和.json扩展名的Vitest工作区配置文件。然而，Vitest实际上还支持更多现代JavaScript模块系统的扩展名，特别是.mts（模块化TypeScript）文件。这一遗漏导致使用.mts扩展名的Vitest工作区配置文件无法被Knip正确识别和处理。

技术细节

模块化TypeScript文件扩展名.mts是TypeScript 4.5引入的新特性，专门用于明确标识ES模块格式的TypeScript文件。与传统的.ts扩展名相比，.mts文件有以下特点：

1. 默认使用ES模块语法
2. 编译后生成.mjs文件
3. 更清晰地表达模块意图
4. 与Node.js的模块系统更紧密集成

影响范围

这一支持缺失会影响以下场景：

• 使用.mts作为Vitest工作区配置的项目
• 采用最新TypeScript模块化实践的项目
• 需要明确区分CommonJS和ES模块的项目

解决方案

该问题的修复相对直接，只需扩展Knip的Vitest插件中配置文件匹配模式，将.mts和.cts等现代扩展名纳入支持范围。具体修改包括：

1. 更新配置文件匹配正则表达式
2. 确保与Vitest官方支持的扩展名保持一致
3. 维护向后兼容性，不影响现有.ts/.js配置文件

最佳实践建议

对于Knip用户和Vitest使用者，建议：

1. 检查项目中Vitest配置文件的扩展名使用情况
2. 如需使用模块化TypeScript特性，可考虑迁移到.mts扩展名
3. 确保Knip版本更新后重新扫描项目以获取完整分析结果

总结

这一改进体现了Knip项目对现代JavaScript/TypeScript生态系统的持续适配，确保工具能够无缝支持最新的语言特性和社区实践。对于开发者而言，及时更新Knip版本可以避免因配置文件扩展名不匹配而导致的分析遗漏问题。