ESLint 自动修复流水线

手动修复 ESLint 问题的痛点

在 JavaScript 和 TypeScript 代码库中，ESLint 会暴露大量代码风格与潜在缺陷问题——从缩进格式到不推荐的变量声明，手动逐个修复不仅耗时，还容易遗漏边缘场景：比如团队共享的代码库中，不同开发者提交的代码风格不一致，手动调整时可能破坏原有逻辑；TypeScript 项目的 @typescript-eslint/recommended 规则涉及类型相关的修正，手动处理效率极低。

流水线的核心工作逻辑

该技能通过 --fix 标志驱动 ESLint 自动执行可自动修复的规则，覆盖两类主流规则集：

• eslint-config-airbnb：统一 Airbnb 风格的代码规范；
• @typescript-eslint/recommended：修正 TypeScript 代码的类型相关问题。

工作步骤分为三步：

1. 扫描目标 JS/TS 代码库，识别所有可自动修复的问题；
2. 执行自动修复，不改动需要人工干预的复杂问题；
3. 生成差异报告，标注修复后的代码变化，方便开发者逐行审查剩余未修复的问题。

适用边界与注意点

该流水线仅处理 ESLint 标记为「可自动修复」的规则（如格式、简单语法问题），涉及逻辑重构、业务规则调整的问题仍需人工处理。使用时需注意环境要求：

• 需安装 Node.js ^20.19.0、^22.13.0 或 >=24（含 SSL 支持，官方发行版默认自带）；
• 若使用 TypeScript 类型定义，需 TypeScript 5.3 及以上版本；
• 需配置 node-linker=hoisted 以避免依赖链接问题。