# 代码质量门禁 ## 概述 项目配置了自动化质量门禁,确保代码提交前通过所有质量检查。 ## 质量检查 ### 1. 代码风格检查 **工具**: ESLint(flat config:`eslint.config.mjs`) **检查时机**: - pre-commit hook:`.husky/pre-commit` → `npx lint-staged` → `.lintstagedrc.json` 仅对 `*.{js,jsx,ts,tsx}` 执行 `eslint --fix` - `npm run lint`(全仓)、`npm run test:all` - CI「🔍 代码质量检查」阶段(`Jenkinsfile`) **检查内容**: - 代码语法错误 - 代码风格规范 - 自动可修复项的格式化(仅暂存文件,pre-commit 阶段) **通过标准**: **0 error**。warning **不判红**——这是本项目的显式裁定(见 `CONTEXT.md`「lint warning 分级与门禁判定口径」);把 warning 清零不是门禁前置条件,但**不得**为凑绿而把它们调成 `off`。 **warning 数量口径(本文件为版本库内的权威记录位)**: > **2026-10-17 本树复测(对标语法批,分支 `worktree-ui-grammar-two-axis`)**:`npm run lint` ⇒ **EXIT=0,`✖ 81 problems (0 errors, 81 warnings)`**。 > 分项相加必须 = 总数,口径自洽才算这条记录可信:**55** `no-console` / **12** `react-hooks/set-state-in-effect` / **8** `@next/next/no-img-element` / > **4** `@typescript-eslint/no-explicit-any` / 各 1 `@next/next/no-sync-scripts`、`@next/next/no-html-link-for-pages`(55+12+8+4+1+1 = 81 ✓)。 > 与下行 2026-09-23 的 104 相差 **−23**,按规则逐项对账为:`no-explicit-any` **25→4(−21)**、`Unused eslint-disable directive` **1→0(−1)**、 > `@next/next/no-img-element` **10→8(−2)**、`set-state-in-effect` **11→12(+1)**、`no-console` **55→55(0)**(−21−1−2+1 = −23 ✓)。 > 归因**已实证到文件**(不是只看方向一致):`da9a5cb6` 时被删掉的文件里 `: any` / `as any` / `` 命中数为 > `home-content-v15.test.tsx` 12、`NewsDetailClient.test.tsx` 8、`home-content-v15.tsx` 4、`insight-card.test.tsx` 3、 > `industry-grid.test.tsx` 2、`hero-particle-field.test.tsx` 2、`case-card.test.tsx` 2(合计 33 处命中 ⇒ 净减 21 条 warning, > 差额是因为命中数 ≠ 告警数:泛型实参、注释里的 `any` 不产生该告警)。复算命令: > `for f in $(git diff --diff-filter=D --name-only ..HEAD | grep -E '\.tsx?$'); do git show :"$f" | grep -cE '(: any|as any|)'; done` > 另记一条本轮真实事故:这条计数一度被读成 0 error 是因为 `npm run lint | tail` 拿到的是 `tail` 的退出码, > 而当时真实输出是 **2 error / EXIT=1**(`react/jsx-no-comment-textnodes` 两处)⇒ 见 `docs/lessons-learned.md` §5.38, > **门禁命令必须重定向到文件后再读 `$?`**: ```bash npm run lint # 看末行 ✖ N problems npm run lint 2>&1 | grep -oE '[a-z@/_-]+/[a-z-]+$' | sort | uniq -c | sort -rn # 分项 ``` > ⚠ 不要再以 `AGENTS.md` §5 为该数字的出处:`AGENTS.md` 被 `.gitignore` 有意排除、从未被 git 跟踪、并由 `next dev` 再生(验收 N-16),其内容不可审、不可回滚、可能随再生丢失,只当本地便签。 **已知例外(须保留原因)**:`eslint.config.mjs` 的按路径 override 只在三类位置降档——`ruixin/e2e-tests`(`e2e/**/*.ts` 关 `no-console`,`:65-71`)、`ruixin/unit-tests`(`**/*.test.{ts,tsx}`、`**/__tests__/**` 关 `@typescript-eslint/no-explicit-any`,`:73-79`)、`ruixin/performance-tests`(`tests/performance/*.js`,`:81`)。**`prisma/seed.ts` 不在任何 override 内**,它的 `no-console` 仍是 warning 形态存在(占 §5 计数的大头),属「种子脚本进度日志」的有意容忍项,而非配置豁免(其数量口径见本节上方的 warning 分项表)。 ### 2. 提交信息规范 **工具**: commitlint **检查时机**: commit-msg hook **检查内容**: - 提交信息格式 - 提交类型合法性 **通过标准**: 符合Conventional Commits规范 **提交类型**: - `feat`: 新功能 - `fix`: 修复bug - `docs`: 文档更新 - `style`: 代码格式调整 - `refactor`: 重构 - `perf`: 性能优化 - `test`: 测试相关 - `chore`: 构建/工具相关 - `revert`: 回滚提交 - `build`: 构建相关 - `ci`: CI/CD相关 **提交信息格式**: ``` ():