应排除配置文件以提升覆盖率统计准确性，需在覆盖率工具中通过路径匹配精准跳过扫描，而非跳过测试执行；Jest用coveragePathIgnorePatterns、nyc用exclude、Vitest用coverage.exclude，并按文件类型区分处理。
JavaScript 项目中，配置文件（如 .env.*、config/*.js、webpack.config.js、vite.config.ts 等）通常不含业务逻辑，只做环境变量注入、构建参数设置或静态导出，统计其覆盖率既无意义，还会拉低整体指标。排除它们的关键是：**让覆盖率工具在扫描源码时跳过这些路径，而不是跳过测试执行**。
用配置项精准排除配置类文件
主流工具都支持通过 glob 或正则匹配路径来忽略：
-
Jest：在
jest.config.js或package.json#jest中设置coveragePathIgnorePatterns，例如：coveragePathIgnorePatterns: ["/config/", "\.env\.", "webpack\.config\.", "vite\.config\."]
注意：该数组接受字符串形式的正则（不带/g标志），会自动转为 RegExp 对象。 -
nyc / Istanbul：在
.nycrc或package.json#nyc中使用exclude字段："exclude": ["config/**", ".env*", "webpack.config.js", "vite.config.ts"] -
Vitest：在
vitest.config.ts的coverage.exclude中填写相同格式的 glob：exclude: ["config/**", "**/.env*", "webpack.config.*", "vite.config.*"]
按文件类型和用途分类排除
不是所有配置文件都值得一刀切排除，需结合内容判断：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
纯键值对的环境文件（如
.env.development、.env.production）：无执行逻辑，建议显式排除； -
JS/TS 配置脚本（如
webpack.config.js）：虽含代码，但运行在构建阶段，不在测试运行时执行，排除更合理； -
运行时配置模块（如
src/config/api.ts导出 baseURL、超时等）：若其中含条件分支（如根据 NODE_ENV 切换地址），应保留并测试，而非排除； -
类型声明或 JSON 配置（如
tsconfig.json、eslint.config.js）：Istanbul 默认不处理非 JS/TS 文件，无需额外配置。
避免常见误操作
排除配置文件时容易踩坑，注意以下几点：
立即学习“Java免费学习笔记（深入）”；
- 不要混淆
transformIgnorePatterns（影响 Jest 转译）和coveragePathIgnorePatterns（仅影响覆盖率扫描）； - 路径匹配基于
rootDir或项目根目录，<rootDir>在 Jest 中可安全引用，但在 nyc 中需用相对路径或绝对路径； - 排除
**/*.config.js可能误伤业务中名为xxx.config.js的逻辑模块，建议限定目录，如config/**/*.js； - 若配置文件被其他模块
require()或import，排除后不会影响测试执行，只影响覆盖率统计结果。
验证是否生效
排除后务必验证效果：
- 运行覆盖率命令（如
nyc npm test或vitest run --coverage）； - 打开生成的
coverage/index.html，检查左侧文件树中是否已不见目标配置文件； - 查看终端输出的 summary，确认总行数、函数数等指标下降，说明排除成功；
- 若仍出现，检查路径是否拼写错误、是否被
collectCoverageFrom显式包含（后者优先级更高）。
