ESLint规则进阶：如何限制仅允许命名空间导入

在JavaScript模块化开发中，ESLint的no-restricted-imports规则通常用于限制特定模块或模块成员的导入。然而，当我们需要更精细地控制导入方式时，比如强制要求只能使用命名空间导入（import * as），标准的no-restricted-imports规则就显得力有未逮了。

命名空间导入的特殊价值

命名空间导入（import * as）在以下场景中特别有用：

1. 当需要明确区分模块来源时
2. 避免命名冲突
3. 保持代码一致性
4. 某些库（如Radashi）推荐使用这种导入方式

解决方案：使用no-restricted-syntax规则

ESLint提供了更底层的no-restricted-syntax规则，通过AST选择器可以精确控制导入方式。以下是实现仅允许命名空间导入的配置：

{
  "rules": {
    "no-restricted-syntax": [
      "error",
      {
        "selector": "ImportDeclaration[source.value='radashi'][specifiers.length=0], ImportDeclaration[source.value='radashi'] > :matches(ImportSpecifier, ImportDefaultSpecifier)",
        "message": "仅允许使用`import * as _ from 'radashi'`方式导入"
      }
    ]
  }
}

选择器解析

这个选择器由两部分组成：

1. ImportDeclaration[source.value='radashi'][specifiers.length=0] - 匹配无具体导入项的副作用导入（如import "radashi"）
2. ImportDeclaration[source.value='radashi'] > :matches(ImportSpecifier, ImportDefaultSpecifier) - 匹配命名导入和默认导入

这样配置后，以下导入方式将被禁止：

import { sort } from "radashi";  // 命名导入
import "radashi";               // 副作用导入
import $ from "radashi";        // 默认导入

而仅允许：

import * as _ from "radashi";   // 命名空间导入

实际应用建议

1. 对于需要严格控制的库（如Radashi），建议在项目共享配置中预设此规则
2. 可以扩展选择器以支持多个模块
3. 考虑添加清晰的错误信息，指导开发者使用正确的导入方式

这种精细化的导入控制对于维护大型项目代码质量和一致性非常有价值，特别是当团队有特定的模块使用规范时。