用途:在包含 package.json、eslint.config.、.eslintrc、tsconfig.json 或 JS/TS/React 前端文件的 .NET 仓库中,为前端资源建立 ESLint 语义检查。适用于用户要求 JS/TS lint、React 规则、import 规范或前端不安全模式检查,以及希望 CI 因前端 lint 失败而中断的场景。
主要能力:检测现有 ESLint 配置、包管理器与工作区布局、React/Next.js/Vue/TypeScript 等框架;保持 ESLint 作为 JS/TS 的语义 lint 归属;优先使用仓库本地 devDependencies 而非全局安装;在 package.json 中添加 lint 与 lint:fix 脚本;支持类型感知规则前先确认 tsconfig.json 覆盖目标文件;按有界目录或 glob 分批自动修复并复跑检查。
使用方式:先运行 rg --files -g 'package.json' -g 'eslint.config.' -g '.eslintrc' -g 'tsconfig.json' 与 rg -n '"eslint"|"@typescript-eslint"|"eslint-plugin-"' --glob 'package.json' . 检测现状;本地安装 npm install --save-dev eslint;按实际框架添加插件;创建或完善 eslint.config.js 或 eslint.config.mjs;添加脚本 lint: eslint . 与 lint:fix: eslint . --fix;用 npx eslint . 和 npx eslint . --fix 验证。
适用场景:.NET 仓库内前端资产的 lint 门禁、CI 阻断、React 规则与 import 卫生检查。
限制:不用于仅 CSS 的场景(应使用 dotnet-stylelint),不用于静态输出的纯 HTML 检查(应使用 dotnet-htmlhint),也不用于已统一采用 Biome 作为唯一 JS/TS 格式化与 lint 工具的仓库,除非明确要求迁移或对比。解析错误通常源于配置或解析器栈与文件集不匹配;规则未找到通常源于缺少插件包或 ESLint 主版本不匹配;文件被忽略通常源于 glob 过宽或忽略项过期。不要通过批量关闭规则掩盖问题。返回状态可为 complete、clean、improved、configured、not_applicable 或 blocked。