前端团队统一JS代码覆盖率标准的核心是建立可度量、可执行、可持续演进的共识机制，重点包括工具链对齐（新项目用Vitest+c8，存量Jest项目统一lcov格式）、阈值分级（按模块重要性设定语句/分支/函数覆盖率要求）、报告透明（CI失败+HTML链接+PR卡片+文档归档）及配套容错（豁免指南、新人练习、季度复盘、CR显性检查）。
前端团队统一 JS 代码覆盖率标准，核心不是追求“100%”，而是建立可度量、可执行、可持续演进的共识机制。重点在于工具链对齐、阈值分级、报告透明和流程卡点。
统一工具链与输出格式
避免各包用不同覆盖率工具（如有的用 Jest + nyc，有的用 Vitest + c8，有的直接跑 c8），会导致路径映射不一致、合并失败、阈值校验不可靠。应明确团队主推方案：
- 新项目默认使用 Vitest + c8（v1.3+），配置
coverage: { provider: 'c8', reporter: ['lcov'] } - 存量 Jest 项目维持
coverageReporters: ['lcov']，禁用 text/json-summary 等非合并友好格式 - 所有子包的
coverageDirectory统一设为coverage，确保 lcov.info 中文件路径前缀一致 - 根目录提供标准化脚本（如
pnpm coverage:collect），自动归集各包coverage/lcov.info到coverage/lcov/并重命名（a.lcov,b.lcov）
分级设定阈值并写入配置
一刀切的全局阈值易失真。建议按模块重要性分层约束：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 核心逻辑层（如
src/core/,src/utils/）：语句 ≥ 90%，分支 ≥ 85% - 业务服务层（如
src/services/）：语句 ≥ 85%，函数 ≥ 80% - UI 组件层（如
src/components/）：语句 ≥ 75%，允许更低但需备注原因 - 所有配置写入根目录
vitest.config.ts或jest.config.js的coverageThreshold字段，禁止仅口头约定
让覆盖率真正“可见”和“可追责”
报告不能只存在本地或 CI 日志里。要让它成为日常开发的一部分：
立即学习“前端免费学习笔记（深入）”；
- CI 流水线中增加
npm run coverage:check步骤，未达标则构建失败，并附带 HTML 报告链接 - 在 GitLab/GitHub PR 页面嵌入覆盖率变化卡片（可用
codecov或自建轻量服务） - 每日站会可快速同步“昨日新增代码的覆盖率是否达标”，形成正向反馈
- 将
coverage/lcov.filtered.info和coverage/report/提交到仓库 docs 目录，供全员随时查阅
配套规范与容错机制
统一标准不是施加压力，而是降低执行门槛：
- 提供《低覆盖率代码豁免指南》：如纯类型定义、路由配置、mock 数据等可申请白名单，但需在代码中标注
// coverage-ignore-line - 新成员入职时，提供含典型低覆盖场景的练习题（如如何为 React 自定义 Hook 写有效测试），而非只讲理论
- 每季度回顾阈值合理性——若连续三周 90% 模块都卡在 89.7%，说明标准脱离实际，需调整或补测
- 把覆盖率纳入 Code Review checklist 显性项：“本次修改是否新增了对应测试？覆盖率是否达标？”
