lint-staged 项目新增对 TypeScript 配置文件的支持

随着 TypeScript 在前端生态中的普及，越来越多的工具开始原生支持 TypeScript 配置文件。近日，流行的 Git 钩子工具 lint-staged 在最新版本 v15.4.0 中正式加入了对 TypeScript 配置文件的支持。

背景与需求

lint-staged 是一个用于在 Git 暂存区文件上运行 linters 的工具，通常用于在提交前自动格式化代码和修复问题。长期以来，它支持 JavaScript 配置文件（如 lint-staged.config.js），但对于使用 TypeScript 的项目，开发者不得不采用变通方案或放弃类型检查的优势。

技术实现方案

在 Node.js 生态中，原生并不支持直接加载 TypeScript 文件。lint-staged 团队考虑了两种实现路径：

1. 内置 TypeScript 解析器：需要引入额外的依赖，会增加包体积和复杂度
2. 依赖 Node.js 原生能力：利用 Node.js 未来的原生 TypeScript 支持

经过评估，团队选择了第二种方案，这主要基于以下考虑：

• 保持项目轻量，不增加额外依赖
• Node.js 23.6.0 及以上版本已开始原生支持 TypeScript 文件
• 对于旧版本 Node.js，开发者可以通过 ts-node 等工具实现兼容

支持的文件类型

新版本支持以下 TypeScript 配置文件格式：

• lint-staged.config.ts - 标准 TypeScript 配置文件
• lint-staged.config.mts - ES 模块格式的 TypeScript 配置文件
• lint-staged.config.cts - CommonJS 模块格式的 TypeScript 配置文件

使用方法

对于不同环境，开发者可以采用以下配置方式：

Node.js 23.6.0+ 用户： 直接创建 TypeScript 配置文件即可自动识别，无需额外配置。

旧版本 Node.js 用户： 可以通过 ts-node 加载器启用支持：

NODE_OPTIONS="--loader ts-node/esm" npx lint-staged

类型支持说明

虽然支持了 TypeScript 配置文件，但需要注意的是，当前版本尚未提供内置的类型定义。这意味着开发者需要自行确保配置对象的类型正确性。团队表示未来可能会考虑添加 @types/lint-staged 包来完善类型支持。

总结

这一改进显著提升了 TypeScript 项目中使用 lint-staged 的体验，使开发者能够在配置文件中获得类型检查和自动补全等 TypeScript 优势功能。随着 Node.js 对 TypeScript 原生支持的不断完善，预计会有更多工具采用类似的方案来简化 TypeScript 项目的配置工作。