用途:在同时包含 .NET 与前端资源的仓库中,为 JavaScript、TypeScript、React 等 Node 前端代码建立 ESLint 检查,使前端 lint 问题可在 CI 中阻断,而不是仅依赖编辑器反馈。不适用于仅检查 CSS(应使用 stylelint)、仅检查静态 HTML(应使用 htmlhint),或在未明确要求迁移/比较时已统一采用 Biome 的仓库。
主要能力:将 ESLint 作为 JS/TS 的语义 lint 负责工具;识别现有配置、包管理器、工作区布局以及 React、Next.js、Vue、纯 TypeScript 等框架;支持按需启用类型感知规则;提供 lint 与 lint:fix 命令。
使用方式:优先使用仓库本地依赖而非全局安装,例如 npm install --save-dev eslint;在 package.json 中添加脚本,如 lint: eslint . 与 lint:fix: eslint . --fix;创建或完善 eslint.config.js 或 eslint.config.mjs;仅在仓库实际使用某框架时添加对应插件;可使用 rg --files -g 'package.json' -g 'eslint.config.' -g '.eslintrc' -g 'tsconfig.json' 检测当前状态,用 npx eslint . 与 npx eslint . --fix 验证。运行自动修复时应先限定目录或 glob,再重跑 lint,并视情况重跑前端构建或测试。启用类型感知规则前需确认目标文件被 tsconfig.json 覆盖。
限制与注意事项:解析错误通常说明配置或解析器与文件集不匹配;规则定义未找到通常说明缺少插件或配置指向了不同的 ESLint 主版本;文件被忽略通常说明 glob 过宽或忽略项过期。不应通过大量禁用规则掩盖问题,应修复代码、缩小范围或分阶段调整严重级别。上游说明提及 ESLint v10.9.1 包含 v10.8.1 的自动修复与误报修正等内容,但具体版本行为以实际运行验证为准。
返回状态可为 complete、clean、improved、configured、not_applicable 或 blocked,并附计划、操作、验证与剩余项。确切安装与使用细节需参考仓库实际配置。