TypeScript ESLint 配置中 disableTypeChecked 的正确使用方式

TypeScript ESLint 项目提供了多种预设配置，其中 disableTypeChecked 配置是一个常用的选项，它允许开发者在不需要类型检查的情况下使用 ESLint。然而，在使用过程中，开发者可能会遇到一些配置上的问题。

问题背景

在 TypeScript ESLint 的文档中，disableTypeChecked 配置的示例使用了 extends 属性。当开发者直接按照文档示例配置时，可能会遇到 ESLint 报错，提示 "extends" 键在扁平配置系统中不受支持。

根本原因

这个问题的出现是因为开发者没有使用 tseslint.config() 辅助函数。TypeScript ESLint 提供了一个特殊的配置辅助函数，它扩展了 ESLint 的扁平配置系统，允许使用 extends 属性来继承预设配置。

正确配置方式

要正确使用 disableTypeChecked 配置，应该按照以下方式编写配置文件：

import tseslint from 'typescript-eslint';

export default tseslint.config(
  {
    extends: [tseslint.configs.disableTypeChecked],
    // 其他配置项...
  }
);

技术细节

1. tseslint.config() 函数是 TypeScript ESLint 提供的特殊包装器
2. 这个包装器在内部处理了配置继承的逻辑
3. 它使得开发者可以继续使用熟悉的 extends 语法
4. 同时兼容 ESLint 的扁平配置系统

最佳实践建议

1. 始终使用 tseslint.config() 来包装配置
2. 检查文档示例中的完整代码结构
3. 当遇到配置问题时，首先确认是否使用了正确的配置包装器
4. 对于复杂配置，考虑分模块组织配置

通过正确使用这些配置方式，开发者可以充分利用 TypeScript ESLint 提供的各种预设配置，同时避免常见的配置错误。