benmosher/eslint-plugin-import
Eslint Plugin Import
eslint-plugin-import 是一个 ESLint 静态分析插件，提供了一套规则和解析器来验证 import 语句，并强制执行关于文件如何导入和导出代码的架构约束。它作为一个模块验证器和解析器，确保 import 声明指向有效文件且引用的符号存在。
该项目识别递归导入链以防止循环依赖，并利用可配置的解析系统来映射别名和非标准文件路径。它还可以通过路径和文件夹模式匹配来区分内部项目文件和外部库依赖项。
该插件涵盖了更广泛的代码质量领域，包括强制执行导入样式的排序和分组、限制特定模块系统以及验证导出可用性以防止运行时错误。它还可以根据文件夹位置限制导入源或禁止特定路径类型。
Features
- ESLint Import Plugins - Provides an ESLint plugin that validates import names, paths, and styles using custom resolvers.
- Import Style Enforcers - Enforces consistent import ordering, grouping, and style across the codebase.
- Export Name Validators - Verifies that named imports match the actual exported symbols of the target module to prevent runtime errors.
- Existence Verifications - Provides static analysis to verify that every import statement points to a file or module physically present on the filesystem.
- JavaScript Module Validation - Checks that import paths are correct and named exports exist to prevent runtime errors in JavaScript projects.
- Module Resolvers - Resolves module paths and maps aliases to verify that import declarations are valid.
- Named Import Export Matchers - Matches named and default imports against actual exports of the target module to ensure availability.
- Custom Module System Resolvers - Provides a pluggable system of resolvers to map import paths using various module system semantics.
- Import Statement Validators - Validates that import declarations point to existing files and follow structural requirements.
- Import Style Transformations - Enforces import ordering and grouping by transforming the abstract syntax tree based on configuration.
- Path-Based Restrictions - Enforces architectural constraints by limiting which files can be imported based on folder location or prohibiting specific path types.
- Circular Dependency Detectors - Scans for recursive import loops in module graphs to identify circular dependencies.
- Module Dependency Graphs - Builds module dependency graphs to detect and prevent circular import loops.
- Module System Restrictions - Forbids the use of specific module systems like CommonJS or AMD to maintain a consistent architectural pattern.
- Module System Restrictions - Restricts the use of specific module formats like CommonJS to ensure a consistent architectural pattern.
- Static Analysis AST Parsing - Parses source code into abstract syntax trees to validate the structure of import and export declarations.
- Architecture and Style Plugins - Manages ES2015+ import/export syntax and paths.
