ESLint 规则审计器

解决 ESLint 配置的历史包袱

随着 ESLint 生态从传统的 .eslintrc 迁移到 eslint.config.js（Flat Config），许多项目面临着新旧配置共存、规则冲突和 API 废弃等问题。手动审计这些配置不仅耗时，还容易遗漏深层依赖。ESLint 规则审计器 专为处理这类技术债而生，帮助开发团队快速定位并修复配置中的潜在隐患，确保代码规范体系的平滑演进。

核心能力与工作流

该工具通过调用底层的 @eslint/eslintrc 和 @eslint/js 配置 API，实现了自动化的静态分析。其核心工作流包含以下关键步骤：

• 扫描与解析：深入项目的配置文件，识别所有已启用的规则及其参数。
• 冲突检测：利用底层 API 比对不同配置文件或环境之间的规则定义，精准捕捉相互矛盾的规则设置。
• 废弃标记：标记出在当前版本中已被废弃或移除的旧式配置项。
• 迁移路径生成：针对检测到的问题，自动生成从 eslintrc 格式到 eslint.config.js 格式的具体迁移建议。

适用边界与注意事项

在使用该审计器时，需确保运行环境满足底层依赖的要求：

• 必须安装指定版本的 Node.js，并且 Node 环境需支持 SSL。
• 如果项目中深度依赖 TypeScript 类型定义，需配置 5.3 或更高版本的 TypeScript 环境。
• 生成的迁移路径提供了参考建议，但复杂的自定义插件逻辑仍需开发者手动验证与调整。