ESLint 配置

1. 工具定位与核心概念

ESLint 是一个完全插件化的 JavaScript 静态代码检查（Linting）工具，旨在强制执行代码质量规范与风格一致性。

1.1. 底层工作机制与核心概念

1. Parser (解析器)：将开发者的 JS 源码转换解析为 AST (抽象语法树)。
2. Rules (规则)：针对 AST 节点运行的断言逻辑。分为内置预定义规则与用户自定义规则。
3. Plugins (插件)：第三方开发者暴露出的自定义 Rules 集合（如支持 Vue 或 React 的语法树验证）。
4. Configuration (配置)：控制哪些 Rules 开启、警告级别以及挂载哪些 Plugins。（传统通过 .eslintrc 或 package.json，v9 起采用全新的扁平化 eslint.config.js）。

---

2. 安装与初始化 (CLI 实战)

全局或局部安装引擎包：

npm install eslint -g

2.1. 脚手架初始化避坑指南

ESLint 生态正在经历从传统配置向 v9 Flat Config 的大版本迁移。

# 前置要求：必须在一个已执行过 npm init 存在 package.json 的项目中运行

# 默认命令：将初始化基于最新的 ESLint v9 扁平化配置格式
npx eslint --init

# 降级指令：如果你的老团队/旧插件尚不支持 v9，需强制生成 v8 的传统 .eslintrc 配置
# 注意：该指令会生成老版配置文件，但随后可能会自动把 package.json 里的依赖刷成 v9，需手动降级 eslint 包版本。
npm init @eslint/config@0

2.2. 日常执行与自动修复

# 扫描指定文件抛出报告
npx eslint demo.js

# 扫描并尝试根据规则自动修复常规风格错误（如分号、缩进）
npx eslint demo.js --fix

3. 参考资料

• ESLint 官方全量文档
• ESLint v8 传统配置中文文档