TypeScript-ESLint 配置中的类型注解问题解析

TypeScript-ESLint 是一个强大的工具，它允许开发者在 ESLint 配置中充分利用 TypeScript 的类型系统。然而，在使用 tseslint.config() 方法时，开发者可能会遇到一些类型注解方面的挑战。

问题背景

当开发者在 .mjs 配置文件中使用 tseslint.config() 方法时，TypeScript 可能会报告以下错误：

TS2742: The inferred type of config cannot be named without a reference to...

这个错误表明 TypeScript 无法在不引用内部模块的情况下命名推断出的类型，这会影响代码的可移植性。

根本原因

这个问题通常出现在以下场景中：

1. 项目配置了 composite: true 的 tsconfig
2. 该设置隐式启用了 declaration: true
3. TypeScript 尝试为 JS 配置文件生成 .d.ts 声明文件

解决方案

临时解决方案

开发者可以尝试使用以下类型注解：

/** @type {import("typescript-eslint/dist/config-helper").InfiniteDepthConfigWithExtends} */
const config = tseslint.config(...);

不过需要注意的是，直接从 dist 目录导入类型并不是推荐的做法，因为这些类型并未正式导出。

推荐做法

TypeScript-ESLint 团队已经意识到这个问题，并计划在未来的版本中修复，使得类型系统能够"开箱即用"。在此之前，建议开发者：

1. 避免在 ESLint 配置中使用 composite: true 的 tsconfig
2. 如果必须使用类型检查，考虑将配置移至 .ts 文件而非 .mjs

最佳实践

对于希望在配置中保持类型安全的开发者，建议：

1. 使用 JSDoc 类型注解时，优先使用项目正式导出的类型
2. 保持配置文件的简洁性，避免过度复杂的类型结构
3. 关注 TypeScript-ESLint 的版本更新，以获取官方的类型支持改进

通过理解这些类型系统的交互原理，开发者可以更有效地利用 TypeScript-ESLint 的强大功能，同时避免配置过程中的类型相关问题。