深入理解Antfu ESLint配置中的import排序规则

在Antfu ESLint配置项目中，import语句的排序是一个重要特性。本文将详细介绍如何自定义perfectionist/sort-imports规则的配置，帮助开发者更好地组织代码中的import语句。

默认配置与覆盖方式

Antfu ESLint配置默认集成了perfectionist插件来处理import排序。当我们需要自定义排序规则时，可以通过在配置文件中覆盖默认设置来实现。基本覆盖方式如下：

import antfu from '@antfu/eslint-config'

export default antfu({
  rules: {
    'perfectionist/sort-imports': ['error', {
      // 自定义配置项
    }]
  }
})

排序规则详解

perfectionist/sort-imports规则提供了丰富的配置选项来控制import语句的排序方式：

分组配置(groups)

groups选项定义了import语句的分组顺序，支持以下分组类型：

1. type - TypeScript类型导入
2. builtin - Node.js内置模块
3. external - 第三方依赖
4. internal - 项目内部模块
5. side-effect - 副作用导入
6. object - 对象导入
7. unknown - 无法识别的导入

每个分组可以单独指定，也可以将相关分组合并为一个数组，表示这些分组在同一级别。

其他重要选项

1. partitionByNewLine - 布尔值，控制在分组间是否添加空行
2. newlinesBetween - 控制分组间的空行行为，可选值包括"always"、"never"和"ignore"
3. order - 排序方向，可选"asc"(升序)或"desc"(降序)
4. type - 排序算法类型，可选"natural"(自然排序)或"alphabetical"(字母顺序)

实际应用示例

以下是一个完整的自定义配置示例，展示了如何精细控制import排序：

import antfu from '@antfu/eslint-config'

export default antfu({
  rules: {
    'perfectionist/sort-imports': ['error', {
      groups: [
        'type',
        ['parent-type', 'sibling-type', 'index-type', 'internal-type'],
        'builtin',
        'external',
        'internal',
        ['parent', 'sibling', 'index'],
        'side-effect',
        'object',
        'unknown'
      ],
      partitionByNewLine: true,
      newlinesBetween: "ignore",
      order: "asc",
      type: "natural"
    }]
  }
})

最佳实践建议

1. 对于大型项目，建议保持一致的import排序规则，这有助于团队协作和代码可读性
2. 将相关模块分组在一起可以提高代码的可维护性
3. 合理使用空行分隔不同功能的import语句组
4. 在团队中明确排序规则，可以将其写入项目规范文档

通过合理配置perfectionist/sort-imports规则，开发者可以创建出更加整洁、一致的代码结构，提升项目的整体质量。