JavaScript|第40章:JavaScript 工程化实践

JavaScript|第40章:JavaScript 工程化实践

工程化

  • [JavaScript|第40章:JavaScript 工程化实践](#JavaScript|第40章:JavaScript 工程化实践)
    • 引言
    • [40.1 问题引入:从"能跑"到"可协作"](#40.1 问题引入:从"能跑"到"可协作")
      • [40.1.1 个人项目与团队项目的分水岭](#40.1.1 个人项目与团队项目的分水岭)
      • [40.1.2 工程化的四个层次](#40.1.2 工程化的四个层次)
    • [40.2 代码规范:ESLint 配置与自定义规则](#40.2 代码规范:ESLint 配置与自定义规则)
      • [40.2.1 ESLint 是什么](#40.2.1 ESLint 是什么)
      • [40.2.2 核心概念:规则(Rule)与严重级别](#40.2.2 核心概念:规则(Rule)与严重级别)
      • [40.2.3 配置文件:从 .eslintrc 到 flat config(ESLint v9+)](#40.2.3 配置文件:从 .eslintrc 到 flat config(ESLint v9+))
      • [40.2.4 常用推荐规则集](#40.2.4 常用推荐规则集)
      • [40.2.5 自定义规则](#40.2.5 自定义规则)
      • [40.2.6 命令行与编辑器集成](#40.2.6 命令行与编辑器集成)
    • [40.3 代码格式化:Prettier 与 EditorConfig](#40.3 代码格式化:Prettier 与 EditorConfig)
      • [40.3.1 Prettier:格式化问题的终结者](#40.3.1 Prettier:格式化问题的终结者)
      • [40.3.2 Prettier 配置](#40.3.2 Prettier 配置)
      • [40.3.3 EditorConfig:跨编辑器统一基础格式](#40.3.3 EditorConfig:跨编辑器统一基础格式)
      • [40.3.4 ESLint + Prettier 协作方案](#40.3.4 ESLint + Prettier 协作方案)
    • [40.4 Git Hooks:husky + lint-staged](#40.4 Git Hooks:husky + lint-staged)
      • [40.4.1 什么是 Git Hooks](#40.4.1 什么是 Git Hooks)
      • [40.4.2 husky:让 Git Hooks 可共享](#40.4.2 husky:让 Git Hooks 可共享)
      • [40.4.3 lint-staged:只对暂存文件做检查](#40.4.3 lint-staged:只对暂存文件做检查)
      • [40.4.4 commitlint:规范 commit message](#40.4.4 commitlint:规范 commit message)
    • [40.5 单元测试:Jest 基础与常见断言](#40.5 单元测试:Jest 基础与常见断言)
      • [40.5.1 什么是单元测试](#40.5.1 什么是单元测试)
      • [40.5.2 Jest 快速上手](#40.5.2 Jest 快速上手)
      • [40.5.3 测试组织:describe / it / expect](#40.5.3 测试组织:describe / it / expect)
      • [40.5.4 常用断言(Matchers)](#40.5.4 常用断言(Matchers))
      • [40.5.5 Mock:隔离外部依赖](#40.5.5 Mock:隔离外部依赖)
      • [40.5.6 异步测试](#40.5.6 异步测试)
      • [40.5.7 覆盖率报告](#40.5.7 覆盖率报告)
      • [40.5.8 Jest vs Vitest](#40.5.8 Jest vs Vitest)
    • [40.6 E2E 测试:Playwright / Cypress 简介](#40.6 E2E 测试:Playwright / Cypress 简介)
      • [40.6.1 什么是 E2E 测试](#40.6.1 什么是 E2E 测试)
      • [40.6.2 Playwright:微软出品的现代 E2E 工具](#40.6.2 Playwright:微软出品的现代 E2E 工具)
      • [40.6.3 Cypress:老牌 E2E 工具](#40.6.3 Cypress:老牌 E2E 工具)
      • [40.6.4 Playwright vs Cypress vs Selenium](#40.6.4 Playwright vs Cypress vs Selenium)
    • [40.7 CI/CD 基本概念与 GitHub Actions 实践](#40.7 CI/CD 基本概念与 GitHub Actions 实践)
      • [40.7.1 什么是 CI/CD](#40.7.1 什么是 CI/CD)
      • [40.7.2 GitHub Actions 核心概念](#40.7.2 GitHub Actions 核心概念)
      • [40.7.3 完整 workflow 示例](#40.7.3 完整 workflow 示例)
      • [40.7.4 常用 Action 与 Secrets](#40.7.4 常用 Action 与 Secrets)
      • [40.7.5 CI/CD 工具对比](#40.7.5 CI/CD 工具对比)
    • [40.8 模块打包工具概述:Webpack、Vite、Rollup、esbuild](#40.8 模块打包工具概述:Webpack、Vite、Rollup、esbuild)
      • [40.8.1 为什么需要打包工具](#40.8.1 为什么需要打包工具)
      • [40.8.2 Webpack:老牌全能选手](#40.8.2 Webpack:老牌全能选手)
      • [40.8.3 Vite:新一代开发体验之王](#40.8.3 Vite:新一代开发体验之王)
      • [40.8.4 Rollup:库打包的首选](#40.8.4 Rollup:库打包的首选)
      • [40.8.5 esbuild:极速打包器](#40.8.5 esbuild:极速打包器)
      • [40.8.6 四者定位对比](#40.8.6 四者定位对比)
    • [40.9 实战:为工具库搭建完整的工程化体系](#40.9 实战:为工具库搭建完整的工程化体系)
      • [40.9.1 项目初始化与目录结构](#40.9.1 项目初始化与目录结构)
      • [40.9.2 编写工具函数源码](#40.9.2 编写工具函数源码)
      • [40.9.3 配置 ESLint + Prettier + EditorConfig](#40.9.3 配置 ESLint + Prettier + EditorConfig)
      • [40.9.4 配置 Jest 单元测试](#40.9.4 配置 Jest 单元测试)
      • [40.9.5 配置 Rollup 打包](#40.9.5 配置 Rollup 打包)
      • [40.9.6 配置 Git Hooks + commitlint](#40.9.6 配置 Git Hooks + commitlint)
      • [40.9.7 配置 GitHub Actions CI](#40.9.7 配置 GitHub Actions CI)
      • [40.9.8 完整的工程化流水线](#40.9.8 完整的工程化流水线)
      • [40.9.9 验证与发布](#40.9.9 验证与发布)
    • 总结

上篇回顾 :第39章:设计模式在 JavaScript 中的应用 --- 我们学习了单例模式(闭包惰性单例、ES Module 天然单例)、观察者模式与发布订阅模式的区别、策略模式消除 if-else、代理与装饰者模式、工厂模式与注册表工厂、适配器模式的接口转换与数据适配,最后在实战中完成了表单验证组合与事件总线设计。

下篇预告 :第41章:性能优化实战 --- 我们将学习浏览器渲染流程(DOM → CSSOM → Layout → Paint → Composite)、重排与重绘的触发与避免、JavaScript 内存管理与垃圾回收、代码分割与懒加载、虚拟滚动、防抖节流、Web Vitals 指标解读与 Chrome DevTools Performance 面板实战分析。


引言

前 39 章我们学完了 JavaScript 的语言基础、异步编程、DOM、事件、模块化、闭包、原型、设计模式等核心知识------这些解决的是"代码怎么写"的问题。但当项目从几十行增长到几万行、从个人项目变成多人协作时,新的问题浮出水面:

  • 张三写 camelCase,李四写 snake_case,代码风格打架
  • 提交了一个 bug,没人知道是谁、什么时候引入的------没有自动测试兜底
  • 每次上线都要手动打包、手动上传,出错概率高、速度慢
  • 新人入职第一天要配置一堆环境,花半天才跑起来

工程化 就是解决"代码怎么协作、怎么交付、怎么持续演进"的系统方法。它不是一种新技术,而是一套工具链 + 流程规范的组合:用 ESLint 统一风格、用 Prettier 自动格式化、用 Git Hooks 拦截低级错误、用 Jest 编写单元测试、用 Playwright 做端到端测试、用 GitHub Actions 跑 CI/CD、用 Vite/Rollup 完成模块打包。

javascript 复制代码
// 没有工程化:每个人风格不同,靠人眼 review
const result = data.map(item=>item.name).filter(name=>name!=='')  // 缺分号、缺空格

// 有工程化:保存文件时 Prettier 自动格式化、ESLint 自动修复
const result = data
  .map((item) => item.name)
  .filter((name) => name !== "");

#mermaid-svg-sMoEA1YNXHiHPwhk{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-sMoEA1YNXHiHPwhk .error-icon{fill:#552222;}#mermaid-svg-sMoEA1YNXHiHPwhk .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-sMoEA1YNXHiHPwhk .marker{fill:#333333;stroke:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk .marker.cross{stroke:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-sMoEA1YNXHiHPwhk p{margin:0;}#mermaid-svg-sMoEA1YNXHiHPwhk .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster-label text{fill:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster-label span{color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster-label span p{background-color:transparent;}#mermaid-svg-sMoEA1YNXHiHPwhk .label text,#mermaid-svg-sMoEA1YNXHiHPwhk span{fill:#333;color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .node rect,#mermaid-svg-sMoEA1YNXHiHPwhk .node circle,#mermaid-svg-sMoEA1YNXHiHPwhk .node ellipse,#mermaid-svg-sMoEA1YNXHiHPwhk .node polygon,#mermaid-svg-sMoEA1YNXHiHPwhk .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .rough-node .label text,#mermaid-svg-sMoEA1YNXHiHPwhk .node .label text,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape .label,#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape .label{text-anchor:middle;}#mermaid-svg-sMoEA1YNXHiHPwhk .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .rough-node .label,#mermaid-svg-sMoEA1YNXHiHPwhk .node .label,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape .label,#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape .label{text-align:center;}#mermaid-svg-sMoEA1YNXHiHPwhk .node.clickable{cursor:pointer;}#mermaid-svg-sMoEA1YNXHiHPwhk .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk .arrowheadPath{fill:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-sMoEA1YNXHiHPwhk .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-sMoEA1YNXHiHPwhk .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-sMoEA1YNXHiHPwhk .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-sMoEA1YNXHiHPwhk .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-sMoEA1YNXHiHPwhk .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster text{fill:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster span{color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-sMoEA1YNXHiHPwhk .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk rect.text{fill:none;stroke-width:0;}#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape p,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape .label rect,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-sMoEA1YNXHiHPwhk .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-sMoEA1YNXHiHPwhk .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-sMoEA1YNXHiHPwhk :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 第40章:JavaScript 工程化实践
代码质量
自动化门禁
测试体系
交付与打包
实战
ESLint 配置与自定义规则 / Prettier / EditorConfig
husky + lint-staged / commitlint
Jest 单元测试 / Playwright E2E 测试
GitHub Actions CI/CD / Webpack·Vite·Rollup·esbuild
工具库 my-utils 全流程工程化

本章目标:

  • 理解工程化的四个层次:代码规范、自动化门禁、测试体系、交付与部署
  • 掌握 ESLint 的配置原理:flat config(v9+)、规则系统、自定义规则
  • 掌握 Prettier 与 EditorConfig 的配置,以及与 ESLint 协作的方案
  • 掌握 husky + lint-staged + commitlint 的 Git Hooks 自动化链路
  • 掌握 Jest 单元测试的完整流程:测试组织、常见断言、Mock、异步测试、覆盖率
  • 了解 Playwright / Cypress 的 E2E 测试理念与基础用法
  • 理解 CI/CD 的基本概念,能编写 GitHub Actions workflow 文件
  • 了解 Webpack、Vite、Rollup、esbuild 四大打包工具的定位与选型
  • 实战:为一个工具库从零搭建完整的工程化体系

40.1 问题引入:从"能跑"到"可协作"

40.1.1 个人项目与团队项目的分水岭

一个人写 500 行代码,不需要任何规范------变量怎么命名、缩进用 tab 还是空格,全凭个人习惯。但当代码量达到 5 万行、团队有 5 个人时,没有规范的项目会迅速腐化:

javascript 复制代码
// person-a 的提交
const getUserInfo = (userId) => {
  return fetch(`/api/user/${userId}`).then(r => r.json());
};

// person-b 的提交(风格完全不同)
function GetUserInfo(user_id)
{
    const url = "/api/user/" + user_id;
    var response = fetch(url)
    return response.then(function(r){return r.json()})
}

这不是谁对谁错的问题,而是不一致本身 就是问题:代码评审时一半的讨论都在争论风格、变量命名不一致导致搜索不到、提交时才发现忘了 console.log、上线后才想起没有测试......

40.1.2 工程化的四个层次

#mermaid-svg-yojGIGwZrk2q9YzA{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-yojGIGwZrk2q9YzA .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-yojGIGwZrk2q9YzA .error-icon{fill:#552222;}#mermaid-svg-yojGIGwZrk2q9YzA .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-yojGIGwZrk2q9YzA .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-yojGIGwZrk2q9YzA .marker{fill:#333333;stroke:#333333;}#mermaid-svg-yojGIGwZrk2q9YzA .marker.cross{stroke:#333333;}#mermaid-svg-yojGIGwZrk2q9YzA svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-yojGIGwZrk2q9YzA p{margin:0;}#mermaid-svg-yojGIGwZrk2q9YzA .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-yojGIGwZrk2q9YzA .cluster-label text{fill:#333;}#mermaid-svg-yojGIGwZrk2q9YzA .cluster-label span{color:#333;}#mermaid-svg-yojGIGwZrk2q9YzA .cluster-label span p{background-color:transparent;}#mermaid-svg-yojGIGwZrk2q9YzA .label text,#mermaid-svg-yojGIGwZrk2q9YzA span{fill:#333;color:#333;}#mermaid-svg-yojGIGwZrk2q9YzA .node rect,#mermaid-svg-yojGIGwZrk2q9YzA .node circle,#mermaid-svg-yojGIGwZrk2q9YzA .node ellipse,#mermaid-svg-yojGIGwZrk2q9YzA .node polygon,#mermaid-svg-yojGIGwZrk2q9YzA .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-yojGIGwZrk2q9YzA .rough-node .label text,#mermaid-svg-yojGIGwZrk2q9YzA .node .label text,#mermaid-svg-yojGIGwZrk2q9YzA .image-shape .label,#mermaid-svg-yojGIGwZrk2q9YzA .icon-shape .label{text-anchor:middle;}#mermaid-svg-yojGIGwZrk2q9YzA .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-yojGIGwZrk2q9YzA .rough-node .label,#mermaid-svg-yojGIGwZrk2q9YzA .node .label,#mermaid-svg-yojGIGwZrk2q9YzA .image-shape .label,#mermaid-svg-yojGIGwZrk2q9YzA .icon-shape .label{text-align:center;}#mermaid-svg-yojGIGwZrk2q9YzA .node.clickable{cursor:pointer;}#mermaid-svg-yojGIGwZrk2q9YzA .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-yojGIGwZrk2q9YzA .arrowheadPath{fill:#333333;}#mermaid-svg-yojGIGwZrk2q9YzA .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-yojGIGwZrk2q9YzA .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-yojGIGwZrk2q9YzA .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-yojGIGwZrk2q9YzA .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-yojGIGwZrk2q9YzA .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-yojGIGwZrk2q9YzA .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-yojGIGwZrk2q9YzA .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-yojGIGwZrk2q9YzA .cluster text{fill:#333;}#mermaid-svg-yojGIGwZrk2q9YzA .cluster span{color:#333;}#mermaid-svg-yojGIGwZrk2q9YzA div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-yojGIGwZrk2q9YzA .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-yojGIGwZrk2q9YzA rect.text{fill:none;stroke-width:0;}#mermaid-svg-yojGIGwZrk2q9YzA .icon-shape,#mermaid-svg-yojGIGwZrk2q9YzA .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-yojGIGwZrk2q9YzA .icon-shape p,#mermaid-svg-yojGIGwZrk2q9YzA .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-yojGIGwZrk2q9YzA .icon-shape .label rect,#mermaid-svg-yojGIGwZrk2q9YzA .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-yojGIGwZrk2q9YzA .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-yojGIGwZrk2q9YzA .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-yojGIGwZrk2q9YzA :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} ① 代码规范

ESLint / Prettier
② 自动化门禁

Git Hooks / CI
③ 测试体系

Jest / Playwright
④ 交付与部署

打包 / 发布 / CI/CD

层次 解决的问题 典型工具
代码规范 统一风格、减少无意义差异 ESLint、Prettier、EditorConfig
自动化门禁 在提交/推送前自动拦截问题 husky、lint-staged、commitlint
测试体系 自动验证代码正确性,防回归 Jest、Vitest、Playwright、Cypress
交付与部署 自动构建、发布、上线 GitHub Actions、Webpack、Vite

工程化不是一次性投入,而是"一次配置,永久受益":配好之后,团队成员只需要关心业务代码,所有质量检查、格式化、测试、发布都由工具链自动完成。


40.2 代码规范:ESLint 配置与自定义规则

40.2.1 ESLint 是什么

ESLint :一个可插拔的 JavaScript(含 JSX / TypeScript)代码静态分析工具 ,通过解析源码为 AST(抽象语法树),对代码执行一组规则,找出不符合规则的写法并报告错误或警告。

ESLint 不关心"缩进用 tab 还是空格"------那是 Prettier 的工作。ESLint 关心的是"代码有没有 bug、有没有坏味道 ":未使用的变量、隐式类型转换、未处理的 Promise、不一致的 this 绑定等。

javascript 复制代码
// ESLint 可以发现的问题:
let x = 10;        // 'x' 已赋值但从未使用(no-unused-vars)
if (x == "10") {}  // 使用 == 而非 ===(eqeqeq)
function fn() {
  console.log(this.name);  // 普通函数中的 this 可能为 undefined(no-invalid-this)
}

40.2.2 核心概念:规则(Rule)与严重级别

每条 ESLint 规则有三个严重级别:

级别 值 含义
"off" 0 关闭此规则
"warn" 1 违反时只警告,不阻止进程(exit code = 0)
"error" 2 违反时报错,阻止进程(exit code = 1)

规则可以接收配置项:

json 复制代码
// 规则配置示例
{
  "rules": {
    "no-unused-vars": "error",                     // 只设级别
    "eqeqeq": ["error", "always"],                  // 级别 + 参数
    "no-console": ["warn", { "allow": ["warn", "error"] }]  // 允许 console.warn / console.error
  }
}

40.2.3 配置文件:从 .eslintrc 到 flat config(ESLint v9+)

ESLint v9 引入了 flat config (扁平配置),用一个 eslint.config.js 取代原来的 .eslintrc.* + .eslintignore:

javascript 复制代码
// eslint.config.js ------ ESLint v9+ flat config
import js from "@eslint/js";
import globals from "globals";

export default [
  // 1. 全局忽略(替代 .eslintignore)
  { ignores: ["dist/**", "node_modules/**"] },

  // 2. 继承推荐规则集
  js.configs.recommended,

  // 3. 自定义配置
  {
    languageOptions: {
      ecmaVersion: 2024,
      sourceType: "module",
      globals: { ...globals.browser, ...globals.node }
    },
    rules: {
      "no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
      "no-console": "warn",
      "prefer-const": "error",
      "eqeqeq": ["error", "always"]
    }
  }
];

flat config 的核心思想 :配置是一个数组 ,后面的配置项覆盖前面的。这比 .eslintrc 的"隐式级联查找"直观得多------你只需要看一个文件就能知道完整配置。
#mermaid-svg-wPMpfhz340AQGXuL{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-wPMpfhz340AQGXuL .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-wPMpfhz340AQGXuL .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-wPMpfhz340AQGXuL .error-icon{fill:#552222;}#mermaid-svg-wPMpfhz340AQGXuL .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-wPMpfhz340AQGXuL .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-wPMpfhz340AQGXuL .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-wPMpfhz340AQGXuL .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-wPMpfhz340AQGXuL .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-wPMpfhz340AQGXuL .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-wPMpfhz340AQGXuL .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-wPMpfhz340AQGXuL .marker{fill:#333333;stroke:#333333;}#mermaid-svg-wPMpfhz340AQGXuL .marker.cross{stroke:#333333;}#mermaid-svg-wPMpfhz340AQGXuL svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-wPMpfhz340AQGXuL p{margin:0;}#mermaid-svg-wPMpfhz340AQGXuL .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-wPMpfhz340AQGXuL .cluster-label text{fill:#333;}#mermaid-svg-wPMpfhz340AQGXuL .cluster-label span{color:#333;}#mermaid-svg-wPMpfhz340AQGXuL .cluster-label span p{background-color:transparent;}#mermaid-svg-wPMpfhz340AQGXuL .label text,#mermaid-svg-wPMpfhz340AQGXuL span{fill:#333;color:#333;}#mermaid-svg-wPMpfhz340AQGXuL .node rect,#mermaid-svg-wPMpfhz340AQGXuL .node circle,#mermaid-svg-wPMpfhz340AQGXuL .node ellipse,#mermaid-svg-wPMpfhz340AQGXuL .node polygon,#mermaid-svg-wPMpfhz340AQGXuL .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-wPMpfhz340AQGXuL .rough-node .label text,#mermaid-svg-wPMpfhz340AQGXuL .node .label text,#mermaid-svg-wPMpfhz340AQGXuL .image-shape .label,#mermaid-svg-wPMpfhz340AQGXuL .icon-shape .label{text-anchor:middle;}#mermaid-svg-wPMpfhz340AQGXuL .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-wPMpfhz340AQGXuL .rough-node .label,#mermaid-svg-wPMpfhz340AQGXuL .node .label,#mermaid-svg-wPMpfhz340AQGXuL .image-shape .label,#mermaid-svg-wPMpfhz340AQGXuL .icon-shape .label{text-align:center;}#mermaid-svg-wPMpfhz340AQGXuL .node.clickable{cursor:pointer;}#mermaid-svg-wPMpfhz340AQGXuL .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-wPMpfhz340AQGXuL .arrowheadPath{fill:#333333;}#mermaid-svg-wPMpfhz340AQGXuL .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-wPMpfhz340AQGXuL .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-wPMpfhz340AQGXuL .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-wPMpfhz340AQGXuL .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-wPMpfhz340AQGXuL .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-wPMpfhz340AQGXuL .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-wPMpfhz340AQGXuL .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-wPMpfhz340AQGXuL .cluster text{fill:#333;}#mermaid-svg-wPMpfhz340AQGXuL .cluster span{color:#333;}#mermaid-svg-wPMpfhz340AQGXuL div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-wPMpfhz340AQGXuL .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-wPMpfhz340AQGXuL rect.text{fill:none;stroke-width:0;}#mermaid-svg-wPMpfhz340AQGXuL .icon-shape,#mermaid-svg-wPMpfhz340AQGXuL .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-wPMpfhz340AQGXuL .icon-shape p,#mermaid-svg-wPMpfhz340AQGXuL .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-wPMpfhz340AQGXuL .icon-shape .label rect,#mermaid-svg-wPMpfhz340AQGXuL .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-wPMpfhz340AQGXuL .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-wPMpfhz340AQGXuL .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-wPMpfhz340AQGXuL :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 源码文件
ESLint CLI / 编辑器插件
eslint.config.js

(flat config 数组)
解析器

生成 AST
逐条规则检查

AST 节点匹配
报告 errors / warnings

40.2.4 常用推荐规则集

规则集 说明 适用场景
eslint:recommended ESLint 官方最小推荐集 所有项目基础
airbnb Airbnb 风格指南(严格) 大型团队、严格风格要求
standard JavaScript Standard Style(无分号) 追求零配置
@typescript-eslint/recommended TypeScript 推荐规则 TS 项目
eslint-config-prettier 关闭所有与 Prettier 冲突的 ESLint 规则 必装(与 Prettier 共存)
shell 复制代码
# 安装推荐依赖
npm install -D eslint @eslint/js globals eslint-config-prettier

40.2.5 自定义规则

ESLint 的每条规则本质是一个访问者对象,对 AST 节点做模式匹配。自定义规则允许你约束团队特有的约定:

javascript 复制代码
// rules/no-date-now-in-loop.js ------ 禁止在循环体内调用 Date.now()
export default {
  meta: {
    type: "suggestion",
    docs: { description: "禁止在循环体内使用 Date.now(),应在循环外缓存" },
    schema: [],
    messages: {
      noDateNow: "避免在循环内调用 Date.now(),请在循环外缓存时间戳"
    }
  },
  create(context) {
    let loopDepth = 0;

    return {
      // 进入循环节点时 +1
      "ForStatement|ForInStatement|ForOfStatement|WhileStatement"() { loopDepth++; },
      ":matches(ForStatement, ForInStatement, ForOfStatement, WhileStatement):exit"() { loopDepth--; },

      // 检查 Date.now() 调用
      "CallExpression[callee.object.name='Date'][callee.property.name='now']"(node) {
        if (loopDepth > 0) {
          context.report({ node, messageId: "noDateNow" });
        }
      }
    };
  }
};

自定义规则的价值:把团队约定从"写在 wiki 里没人看"变成"ESLint 直接报错"。常见的如"禁止在组件里直接调 API"、"所有 export 的函数必须有 JSDoc"等。

40.2.6 命令行与编辑器集成

shell 复制代码
# 检查所有 src 目录
npx eslint src/

# 检查并自动修复
npx eslint src/ --fix

# 指定配置文件
npx eslint --config eslint.config.js src/

在编辑器中安装 ESLint 插件后,代码会实时标红------不必等到提交时才发现。

经验法则 :ESLint 用 --fix 能自动修复的问题,绝不要手动修;把人的精力留给无法自动修复的逻辑问题。


40.3 代码格式化:Prettier 与 EditorConfig

40.3.1 Prettier:格式化问题的终结者

Prettier :一个固执己见的代码格式化工具------它有一套默认规则(引号用双、行宽 80、trailing comma),把"风格之争"变成"不用争"。

Prettier 与 ESLint 的分工非常清晰:

职责 ESLint Prettier
代码逻辑问题 ✅ 未使用变量、隐式转换、不一致的 this ❌ 不关心
代码风格问题 ⚠️ 可以但不推荐 ✅ 唯一职责
自动修复能力 --fix 修复部分规则 全量格式化
配置复杂度 数百条规则 少数几个选项
javascript 复制代码
// 格式化前:每个人风格不同
const fn=x=>{return{x:1,y:2,z:3,w:4,a:5,b:6,c:7,d:8,e:9,f:10,g:11,h:12}}

// Prettier 格式化后(行宽 80、自动换行、trailing comma)
const fn = (x) => {
  return {
    x: 1,
    y: 2,
    z: 3,
    w: 4,
    a: 5,
    b: 6,
    c: 7,
    d: 8,
    e: 9,
    f: 10,
    g: 11,
    h: 12,
  };
};

40.3.2 Prettier 配置

json 复制代码
// .prettierrc
{
  "semi": true,
  "singleQuote": false,
  "trailingComma": "all",
  "printWidth": 100,
  "tabWidth": 2,
  "arrowParens": "always",
  "endOfLine": "lf",
  "bracketSpacing": true
}
shell 复制代码
# 格式化所有 JS/TS 文件
npx prettier --write "src/**/*.{js,ts,jsx,tsx}"

忽略文件 :.prettierignore(与 .gitignore 语法相同)。

40.3.3 EditorConfig:跨编辑器统一基础格式

EditorConfig:一个跨编辑器(VS Code、IntelliJ、Vim)的基础格式协议------确保不同编辑器打开同一项目时,缩进、行尾符、字符集等基础格式一致。

ini 复制代码
# .editorconfig ------ 项目根目录
root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.md]
trim_trailing_whitespace = false

[*.{yml,yaml}]
indent_size = 2

EditorConfig 在 Prettier 之前生效------它保证编辑器打开文件时的"第一印象"一致,Prettier 再在此基础上做精确格式化。

40.3.4 ESLint + Prettier 协作方案

ESLint 的某些规则(如 semi、quotes)与 Prettier 冲突------两者都会管,就会打架。解决方案是两步走:

shell 复制代码
npm install -D eslint-config-prettier    # 关闭与 Prettier 冲突的 ESLint 规则
javascript 复制代码
// eslint.config.js
import js from "@eslint/js";
import eslintConfigPrettier from "eslint-config-prettier";

export default [
  js.configs.recommended,
  // ...你的自定义配置...
  eslintConfigPrettier   // 必须放在最后:关闭冲突规则
];

渲染错误: Mermaid 渲染失败: Parse error on line 4: ... E -->|规则冲突? --> FIX["eslint-config-pret -----------------------^ Expecting 'SQE', 'DOUBLECIRCLEEND', 'PE', '-)', 'STADIUMEND', 'SUBROUTINEEND', 'PIPE', 'CYLINDEREND', 'DIAMOND_STOP', 'TAGEND', 'TRAPEND', 'INVTRAPEND', 'UNICODE_TEXT', 'TEXT', 'TAGSTART', got 'SQS'

最佳实践 :编辑器安装 ESLint + Prettier 插件 → 保存时自动执行 Prettier → ESLint --fix 修复逻辑问题。团队用 .editorconfig + .prettierrc + eslint.config.js 三个文件覆盖全部格式需求。


40.4 Git Hooks:husky + lint-staged

40.4.1 什么是 Git Hooks

Git Hooks:Git 在特定事件(commit、push、merge)前后自动执行的脚本。最常见的两个:

  • pre-commit:git commit 执行前触发,适合运行 lint 和测试
  • commit-msg:git commit 时验证 commit message 格式

原生 Git Hooks 是 Shell 脚本,放在 .git/hooks/ 目录------但这个目录不会被提交到仓库,团队协作时无法共享。husky 解决了这个问题。

40.4.2 husky:让 Git Hooks 可共享

shell 复制代码
# 安装 husky
npm install -D husky
npx husky init   # 初始化:创建 .husky/ 目录 + 修改 package.json

初始化后项目目录多了一个 .husky/ 文件夹:

复制代码
.husky/
├── pre-commit      # 提交前执行
└── commit-msg      # 验证 commit message
shell 复制代码
# .husky/pre-commit
npx lint-staged

# .husky/commit-msg
npx --no -- commitlint --edit "$1"

.husky/ 目录随代码一起提交到 Git------团队所有成员共享同一套 Hooks。

40.4.3 lint-staged:只对暂存文件做检查

如果每次 commit 都对整个项目 做 ESLint 检查,大项目会非常慢。lint-staged 只对 git add 的暂存文件执行命令:

json 复制代码
// package.json 中配置
{
  "lint-staged": {
    "*.{js,ts,jsx,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{css,scss,md,json}": [
      "prettier --write"
    ]
  }
}

工作流程:
#mermaid-svg-vadgKU8ninhR0EhJ{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-vadgKU8ninhR0EhJ .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-vadgKU8ninhR0EhJ .error-icon{fill:#552222;}#mermaid-svg-vadgKU8ninhR0EhJ .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-vadgKU8ninhR0EhJ .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-vadgKU8ninhR0EhJ .marker{fill:#333333;stroke:#333333;}#mermaid-svg-vadgKU8ninhR0EhJ .marker.cross{stroke:#333333;}#mermaid-svg-vadgKU8ninhR0EhJ svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-vadgKU8ninhR0EhJ p{margin:0;}#mermaid-svg-vadgKU8ninhR0EhJ .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-vadgKU8ninhR0EhJ .cluster-label text{fill:#333;}#mermaid-svg-vadgKU8ninhR0EhJ .cluster-label span{color:#333;}#mermaid-svg-vadgKU8ninhR0EhJ .cluster-label span p{background-color:transparent;}#mermaid-svg-vadgKU8ninhR0EhJ .label text,#mermaid-svg-vadgKU8ninhR0EhJ span{fill:#333;color:#333;}#mermaid-svg-vadgKU8ninhR0EhJ .node rect,#mermaid-svg-vadgKU8ninhR0EhJ .node circle,#mermaid-svg-vadgKU8ninhR0EhJ .node ellipse,#mermaid-svg-vadgKU8ninhR0EhJ .node polygon,#mermaid-svg-vadgKU8ninhR0EhJ .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-vadgKU8ninhR0EhJ .rough-node .label text,#mermaid-svg-vadgKU8ninhR0EhJ .node .label text,#mermaid-svg-vadgKU8ninhR0EhJ .image-shape .label,#mermaid-svg-vadgKU8ninhR0EhJ .icon-shape .label{text-anchor:middle;}#mermaid-svg-vadgKU8ninhR0EhJ .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-vadgKU8ninhR0EhJ .rough-node .label,#mermaid-svg-vadgKU8ninhR0EhJ .node .label,#mermaid-svg-vadgKU8ninhR0EhJ .image-shape .label,#mermaid-svg-vadgKU8ninhR0EhJ .icon-shape .label{text-align:center;}#mermaid-svg-vadgKU8ninhR0EhJ .node.clickable{cursor:pointer;}#mermaid-svg-vadgKU8ninhR0EhJ .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-vadgKU8ninhR0EhJ .arrowheadPath{fill:#333333;}#mermaid-svg-vadgKU8ninhR0EhJ .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-vadgKU8ninhR0EhJ .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-vadgKU8ninhR0EhJ .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-vadgKU8ninhR0EhJ .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-vadgKU8ninhR0EhJ .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-vadgKU8ninhR0EhJ .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-vadgKU8ninhR0EhJ .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-vadgKU8ninhR0EhJ .cluster text{fill:#333;}#mermaid-svg-vadgKU8ninhR0EhJ .cluster span{color:#333;}#mermaid-svg-vadgKU8ninhR0EhJ div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-vadgKU8ninhR0EhJ .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-vadgKU8ninhR0EhJ rect.text{fill:none;stroke-width:0;}#mermaid-svg-vadgKU8ninhR0EhJ .icon-shape,#mermaid-svg-vadgKU8ninhR0EhJ .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-vadgKU8ninhR0EhJ .icon-shape p,#mermaid-svg-vadgKU8ninhR0EhJ .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-vadgKU8ninhR0EhJ .icon-shape .label rect,#mermaid-svg-vadgKU8ninhR0EhJ .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-vadgKU8ninhR0EhJ .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-vadgKU8ninhR0EhJ .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-vadgKU8ninhR0EhJ :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 通过
通过
失败
符合
不符合
开发者修改代码
git add 暂存文件
git commit
husky 触发 pre-commit
lint-staged 取暂存文件列表
ESLint --fix 检查 JS/TS
Prettier --write 格式化所有文件
commit 继续执行
commit 被阻止

开发者修复后重试
husky 触发 commit-msg
commitlint 验证 message 格式
commit 成功
commit 被阻止

40.4.4 commitlint:规范 commit message

统一 commit message 格式的好处:自动生成 CHANGELOG、git log 可搜索、快速定位变更类型。

shell 复制代码
npm install -D @commitlint/cli @commitlint/config-conventional
javascript 复制代码
// commitlint.config.js
export default {
  extends: ["@commitlint/config-conventional"],
  rules: {
    "type-enum": [
      2, "always",
      ["feat", "fix", "docs", "style", "refactor", "perf", "test", "build", "ci", "chore", "revert"]
    ],
    "subject-max-length": [2, "always", 100]
  }
};
shell 复制代码
# ✅ 符合规范
git commit -m "feat(auth): 添加 JWT token 刷新逻辑"
git commit -m "fix(cart): 修复数量为 0 时的结算价格计算"
git commit -m "docs: 更新 README 安装说明"

# ❌ 不符合规范(commitlint 报错)
git commit -m "fix bug"              # 缺少 type scope
git commit -m "update code"          # type 不合法
type 含义
feat 新功能
fix 修复 bug
docs 文档变更
style 代码格式(不影响逻辑)
refactor 重构(非新功能、非修复)
perf 性能优化
test 测试相关
chore 构建/工具链变更
revert 回滚

经验法则 :husky + lint-staged + commitlint 的"三道门禁"配合后,git commit 变成了一套全自动的质量流水线:代码必须 lint 通过 → 格式必须统一 → message 必须规范 → 才能提交。


40.5 单元测试:Jest 基础与常见断言

40.5.1 什么是单元测试

单元测试 :对代码的最小可测试单元(函数、类、模块)进行独立测试,验证其在给定输入下的输出是否符合预期。

测试金字塔:
#mermaid-svg-MPCmw5z9moVOtOps{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-MPCmw5z9moVOtOps .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-MPCmw5z9moVOtOps .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-MPCmw5z9moVOtOps .error-icon{fill:#552222;}#mermaid-svg-MPCmw5z9moVOtOps .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-MPCmw5z9moVOtOps .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-MPCmw5z9moVOtOps .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-MPCmw5z9moVOtOps .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-MPCmw5z9moVOtOps .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-MPCmw5z9moVOtOps .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-MPCmw5z9moVOtOps .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-MPCmw5z9moVOtOps .marker{fill:#333333;stroke:#333333;}#mermaid-svg-MPCmw5z9moVOtOps .marker.cross{stroke:#333333;}#mermaid-svg-MPCmw5z9moVOtOps svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-MPCmw5z9moVOtOps p{margin:0;}#mermaid-svg-MPCmw5z9moVOtOps .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-MPCmw5z9moVOtOps .cluster-label text{fill:#333;}#mermaid-svg-MPCmw5z9moVOtOps .cluster-label span{color:#333;}#mermaid-svg-MPCmw5z9moVOtOps .cluster-label span p{background-color:transparent;}#mermaid-svg-MPCmw5z9moVOtOps .label text,#mermaid-svg-MPCmw5z9moVOtOps span{fill:#333;color:#333;}#mermaid-svg-MPCmw5z9moVOtOps .node rect,#mermaid-svg-MPCmw5z9moVOtOps .node circle,#mermaid-svg-MPCmw5z9moVOtOps .node ellipse,#mermaid-svg-MPCmw5z9moVOtOps .node polygon,#mermaid-svg-MPCmw5z9moVOtOps .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-MPCmw5z9moVOtOps .rough-node .label text,#mermaid-svg-MPCmw5z9moVOtOps .node .label text,#mermaid-svg-MPCmw5z9moVOtOps .image-shape .label,#mermaid-svg-MPCmw5z9moVOtOps .icon-shape .label{text-anchor:middle;}#mermaid-svg-MPCmw5z9moVOtOps .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-MPCmw5z9moVOtOps .rough-node .label,#mermaid-svg-MPCmw5z9moVOtOps .node .label,#mermaid-svg-MPCmw5z9moVOtOps .image-shape .label,#mermaid-svg-MPCmw5z9moVOtOps .icon-shape .label{text-align:center;}#mermaid-svg-MPCmw5z9moVOtOps .node.clickable{cursor:pointer;}#mermaid-svg-MPCmw5z9moVOtOps .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-MPCmw5z9moVOtOps .arrowheadPath{fill:#333333;}#mermaid-svg-MPCmw5z9moVOtOps .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-MPCmw5z9moVOtOps .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-MPCmw5z9moVOtOps .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-MPCmw5z9moVOtOps .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-MPCmw5z9moVOtOps .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-MPCmw5z9moVOtOps .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-MPCmw5z9moVOtOps .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-MPCmw5z9moVOtOps .cluster text{fill:#333;}#mermaid-svg-MPCmw5z9moVOtOps .cluster span{color:#333;}#mermaid-svg-MPCmw5z9moVOtOps div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-MPCmw5z9moVOtOps .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-MPCmw5z9moVOtOps rect.text{fill:none;stroke-width:0;}#mermaid-svg-MPCmw5z9moVOtOps .icon-shape,#mermaid-svg-MPCmw5z9moVOtOps .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-MPCmw5z9moVOtOps .icon-shape p,#mermaid-svg-MPCmw5z9moVOtOps .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-MPCmw5z9moVOtOps .icon-shape .label rect,#mermaid-svg-MPCmw5z9moVOtOps .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-MPCmw5z9moVOtOps .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-MPCmw5z9moVOtOps .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-MPCmw5z9moVOtOps :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} E2E 测试

(Playwright / Cypress)

慢、少、贵
集成测试

(模块组合测试)
单元测试

(Jest / Vitest)

快、多、便宜

单元测试的 FIRST 原则:

原则 含义
Fast 每个测试应毫秒级完成
Isolated 测试之间互不影响
Repeatable 同样输入,同样输出
Self-validating 自动判断 pass / fail,不需要人眼核对
Timely 测试与代码同步编写(理想状态是 TDD)

40.5.2 Jest 快速上手

shell 复制代码
npm install -D jest
json 复制代码
// package.json
{
  "scripts": {
    "test": "jest",
    "test:watch": "jest --watch",
    "test:coverage": "jest --coverage"
  }
}

测试文件的约定位置:

复制代码
src/
├── utils/
│   ├── math.js
│   └── __tests__/
│       └── math.test.js          ← Jest 默认匹配
├── math.spec.js                  ← 也匹配

40.5.3 测试组织:describe / it / expect

javascript 复制代码
// src/utils/math.js
export function add(a, b) { return a + b; }
export function divide(a, b) {
  if (b === 0) throw new Error("除数不能为 0");
  return a / b;
}

// src/utils/__tests__/math.test.js
import { add, divide } from "../math.js";

describe("add", () => {
  it("两正数相加", () => {
    expect(add(1, 2)).toBe(3);
  });

  it("负数相加", () => {
    expect(add(-1, -2)).toBe(-3);
  });

  it("浮点数相加有精度问题(用 toBeCloseTo)", () => {
    expect(add(0.1, 0.2)).toBeCloseTo(0.3);
  });
});

describe("divide", () => {
  it("正常除法", () => {
    expect(divide(10, 2)).toBe(5);
  });

  it("除数为 0 抛出异常", () => {
    expect(() => divide(10, 0)).toThrow("除数不能为 0");
  });
});

40.5.4 常用断言(Matchers)

断言 用途 示例
toBe(val) 严格相等(===) expect(1 + 1).toBe(2)
toEqual(val) 深度相等(对象/数组) expect({ a: 1 }).toEqual({ a: 1 })
toContain(item) 数组包含某元素 expect([1, 2, 3]).toContain(2)
toBeNull() / toBeDefined() null / undefined 检查 expect(result).toBeNull()
toBeTruthy() / toBeFalsy() 真值 / 假值 expect("").toBeFalsy()
toThrow(msg?) 函数抛出异常 expect(() => fn()).toThrow("err")
toBeCloseTo(val) 浮点近似相等 expect(0.1 + 0.2).toBeCloseTo(0.3)
toMatch(regex) 字符串匹配正则 expect("hello").toMatch(/^he/)
toHaveLength(n) 数组/字符串长度 expect([1, 2]).toHaveLength(2)
toHaveBeenCalled() 函数被调用 expect(spy).toHaveBeenCalled()

toBe vs toEqual :toBe 用 === 比较,对对象比较的是引用;toEqual 递归比较对象的每个属性。对象用 toEqual,基本类型用 toBe。

40.5.5 Mock:隔离外部依赖

javascript 复制代码
// src/services/api.js
export async function fetchUser(id) {
  const res = await fetch(`/api/users/${id}`);
  return res.json();
}

// src/services/user.js
import { fetchUser } from "./api.js";
export async function getUserName(id) {
  const user = await fetchUser(id);
  return user.name;
}

// src/services/__tests__/user.test.js
import { getUserName } from "../user.js";
import { fetchUser } from "../api.js";

jest.mock("../api.js");  // 将 fetchUser 替换为 mock 函数

describe("getUserName", () => {
  beforeEach(() => {
    jest.clearAllMocks();
  });

  it("返回用户名称", async () => {
    fetchUser.mockResolvedValue({ id: 1, name: "Tom" });
    const name = await getUserName(1);
    expect(name).toBe("Tom");
    expect(fetchUser).toHaveBeenCalledWith(1);
  });

  it("网络错误时抛出异常", async () => {
    fetchUser.mockRejectedValue(new Error("网络错误"));
    await expect(getUserName(1)).rejects.toThrow("网络错误");
  });
});

三种 Mock 方式:

方式 用法 场景
jest.fn() 创建一个空的 mock 函数 传给回调参数
jest.mock("module") 整个模块替换为 mock 隔离网络/文件等外部依赖
jest.spyOn(obj, "method") 监听真实方法的调用 验证调用次数/参数,不改变行为

40.5.6 异步测试

javascript 复制代码
// 写法一:async/await(推荐)
it("获取用户信息", async () => {
  const user = await getUser(1);
  expect(user.name).toBe("Tom");
});

// 写法二:返回 Promise
it("获取用户信息", () => {
  return getUser(1).then(user => {
    expect(user.name).toBe("Tom");
  });
});

// 写法三:done 回调(不推荐,容易忘记调用)
it("获取用户信息", (done) => {
  getUser(1).then(user => {
    expect(user.name).toBe("Tom");
    done();
  });
});

40.5.7 覆盖率报告

shell 复制代码
npx jest --coverage
复制代码
----------|---------|----------|---------|---------|
File      | % Stmts | % Branch | % Funcs | % Lines |
----------|---------|----------|---------|---------|
All files |   85.71 |    75.00 |  100.00 |   85.71 |
 math.js  |  100.00 |   100.00 |  100.00 |  100.00 |
 user.js  |   71.42 |    50.00 |  100.00 |   71.42 |
----------|---------|----------|---------|---------|

覆盖率目标 :核心工具函数 ≥ 90%,UI 组件 ≥ 70%,100% 覆盖率不是目标------100% 的边际收益递减,把精力放在复杂分支和边界条件上更有价值。

40.5.8 Jest vs Vitest

对比维度 Jest Vitest
运行环境 Node.js(JSDOM 模拟浏览器) 原生支持 Vite 的 HMR
配置 独立配置 复用 Vite 配置
速度 中 快(利用 Vite 的 ESM 即时转换)
生态成熟度 最成熟,插件最多 快速增长中
适用 独立 Node 项目、老项目 Vite 项目首选

选型建议:新项目用 Vite 的直接选 Vitest(API 与 Jest 几乎一致);其他项目继续用 Jest 即可。


40.6 E2E 测试:Playwright / Cypress 简介

40.6.1 什么是 E2E 测试

E2E(End-to-End)测试:模拟真实用户操作浏览器,从 UI 层面验证整个系统的行为是否符合预期------点击按钮、填写表单、等待页面加载、断言 DOM 元素......

E2E 测试在测试金字塔中位于顶层:运行最慢、数量最少,但最接近用户真实场景。
#mermaid-svg-uGVeYWcJXblLKjVe{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-uGVeYWcJXblLKjVe .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-uGVeYWcJXblLKjVe .error-icon{fill:#552222;}#mermaid-svg-uGVeYWcJXblLKjVe .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-uGVeYWcJXblLKjVe .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-uGVeYWcJXblLKjVe .marker{fill:#333333;stroke:#333333;}#mermaid-svg-uGVeYWcJXblLKjVe .marker.cross{stroke:#333333;}#mermaid-svg-uGVeYWcJXblLKjVe svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-uGVeYWcJXblLKjVe p{margin:0;}#mermaid-svg-uGVeYWcJXblLKjVe .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-uGVeYWcJXblLKjVe .cluster-label text{fill:#333;}#mermaid-svg-uGVeYWcJXblLKjVe .cluster-label span{color:#333;}#mermaid-svg-uGVeYWcJXblLKjVe .cluster-label span p{background-color:transparent;}#mermaid-svg-uGVeYWcJXblLKjVe .label text,#mermaid-svg-uGVeYWcJXblLKjVe span{fill:#333;color:#333;}#mermaid-svg-uGVeYWcJXblLKjVe .node rect,#mermaid-svg-uGVeYWcJXblLKjVe .node circle,#mermaid-svg-uGVeYWcJXblLKjVe .node ellipse,#mermaid-svg-uGVeYWcJXblLKjVe .node polygon,#mermaid-svg-uGVeYWcJXblLKjVe .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-uGVeYWcJXblLKjVe .rough-node .label text,#mermaid-svg-uGVeYWcJXblLKjVe .node .label text,#mermaid-svg-uGVeYWcJXblLKjVe .image-shape .label,#mermaid-svg-uGVeYWcJXblLKjVe .icon-shape .label{text-anchor:middle;}#mermaid-svg-uGVeYWcJXblLKjVe .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-uGVeYWcJXblLKjVe .rough-node .label,#mermaid-svg-uGVeYWcJXblLKjVe .node .label,#mermaid-svg-uGVeYWcJXblLKjVe .image-shape .label,#mermaid-svg-uGVeYWcJXblLKjVe .icon-shape .label{text-align:center;}#mermaid-svg-uGVeYWcJXblLKjVe .node.clickable{cursor:pointer;}#mermaid-svg-uGVeYWcJXblLKjVe .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-uGVeYWcJXblLKjVe .arrowheadPath{fill:#333333;}#mermaid-svg-uGVeYWcJXblLKjVe .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-uGVeYWcJXblLKjVe .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-uGVeYWcJXblLKjVe .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-uGVeYWcJXblLKjVe .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-uGVeYWcJXblLKjVe .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-uGVeYWcJXblLKjVe .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-uGVeYWcJXblLKjVe .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-uGVeYWcJXblLKjVe .cluster text{fill:#333;}#mermaid-svg-uGVeYWcJXblLKjVe .cluster span{color:#333;}#mermaid-svg-uGVeYWcJXblLKjVe div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-uGVeYWcJXblLKjVe .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-uGVeYWcJXblLKjVe rect.text{fill:none;stroke-width:0;}#mermaid-svg-uGVeYWcJXblLKjVe .icon-shape,#mermaid-svg-uGVeYWcJXblLKjVe .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-uGVeYWcJXblLKjVe .icon-shape p,#mermaid-svg-uGVeYWcJXblLKjVe .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-uGVeYWcJXblLKjVe .icon-shape .label rect,#mermaid-svg-uGVeYWcJXblLKjVe .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-uGVeYWcJXblLKjVe .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-uGVeYWcJXblLKjVe .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-uGVeYWcJXblLKjVe :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 测试金字塔
E2E 测试

慢 · 少 · 高保真
集成测试

模块组合
单元测试

快 · 多 · 低成本

40.6.2 Playwright:微软出品的现代 E2E 工具

核心优势:

  • 多浏览器:Chromium、Firefox、WebKit 全覆盖
  • 自动等待:操作前自动等待元素可见、可交互
  • 跨 tab / iframe:原生支持多页面场景
  • 录制模式 :codegen 命令录制操作,自动生成测试代码
  • Trace 回放:失败时自动录制操作 trace,可视化回放定位问题
shell 复制代码
npm install -D @playwright/test
npx playwright install    # 安装浏览器引擎
javascript 复制代码
// e2e/login.spec.js
import { test, expect } from "@playwright/test";

test("用户登录流程", async ({ page }) => {
  await page.goto("https://myapp.com/login");

  // 填写表单
  await page.fill("#username", "testuser");
  await page.fill("#password", "123456");
  await page.click("button[type='submit']");

  // 验证跳转到首页
  await expect(page).toHaveURL("/dashboard");
  await expect(page.locator(".welcome")).toContainText("欢迎, testuser");
});

test("密码错误时显示提示", async ({ page }) => {
  await page.goto("https://myapp.com/login");
  await page.fill("#username", "testuser");
  await page.fill("#password", "wrong");
  await page.click("button[type='submit']");

  await expect(page.locator(".error-msg")).toBeVisible();
  await expect(page.locator(".error-msg")).toContainText("密码不正确");
});
shell 复制代码
# 运行所有 E2E 测试
npx playwright test

# 运行指定浏览器
npx playwright test --project=chromium

# 录制模式:操作后自动生成代码
npx playwright codegen https://myapp.com

40.6.3 Cypress:老牌 E2E 工具

Cypress 在 Playwright 之前是最流行的前端 E2E 工具,以实时重载 和时间旅行调试著称:

javascript 复制代码
// cypress/e2e/login.cy.js
describe("用户登录", () => {
  it("填写正确密码后跳转到首页", () => {
    cy.visit("/login");
    cy.get("#username").type("testuser");
    cy.get("#password").type("123456");
    cy.get("button[type='submit']").click();

    cy.url().should("include", "/dashboard");
    cy.get(".welcome").should("contain", "欢迎, testuser");
  });

  it("拦截网络请求做 Mock 测试", () => {
    cy.intercept("POST", "/api/login", {
      statusCode: 200,
      body: { token: "mock-token", user: { name: "Tom" } }
    }).as("loginRequest");

    cy.visit("/login");
    cy.get("#username").type("testuser");
    cy.get("#password").type("123456");
    cy.get("button[type='submit']").click();

    cy.wait("@loginRequest").its("request.body").should("deep.equal", {
      username: "testuser",
      password: "123456"
    });
  });
});

40.6.4 Playwright vs Cypress vs Selenium

对比维度 Playwright Cypress Selenium
浏览器支持 Chromium / Firefox / WebKit Chromium(实验性支持 Firefox) 所有主流浏览器
语言支持 JS/TS / Python / Java / .NET 仅 JS/TS 多语言
自动等待 内置 内置 需要手写
多 tab / iframe 原生支持 有限支持 原生支持
调试体验 Trace 回放 时间旅行 传统调试
运行速度 快(并行) 中等 慢
社区生态 快速增长 成熟 最成熟
适用场景 新项目首选 中小型前端项目 企业级遗留系统

选型建议:2024 年后的新项目首选 Playwright(多浏览器、速度快、微软维护积极);已有 Cypress 基础设施的项目继续用 Cypress 即可。


40.7 CI/CD 基本概念与 GitHub Actions 实践

40.7.1 什么是 CI/CD

CI(持续集成) :开发者频繁地将代码合并到主干,每次合并自动触发构建、lint、测试------在 bug 引入的第一时间发现它。

CD(持续交付/部署):CI 通过后,自动将代码发布到预发布/生产环境。
#mermaid-svg-GXKibZqBb0UK50lc{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-GXKibZqBb0UK50lc .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-GXKibZqBb0UK50lc .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-GXKibZqBb0UK50lc .error-icon{fill:#552222;}#mermaid-svg-GXKibZqBb0UK50lc .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-GXKibZqBb0UK50lc .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-GXKibZqBb0UK50lc .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-GXKibZqBb0UK50lc .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-GXKibZqBb0UK50lc .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-GXKibZqBb0UK50lc .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-GXKibZqBb0UK50lc .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-GXKibZqBb0UK50lc .marker{fill:#333333;stroke:#333333;}#mermaid-svg-GXKibZqBb0UK50lc .marker.cross{stroke:#333333;}#mermaid-svg-GXKibZqBb0UK50lc svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-GXKibZqBb0UK50lc p{margin:0;}#mermaid-svg-GXKibZqBb0UK50lc .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-GXKibZqBb0UK50lc .cluster-label text{fill:#333;}#mermaid-svg-GXKibZqBb0UK50lc .cluster-label span{color:#333;}#mermaid-svg-GXKibZqBb0UK50lc .cluster-label span p{background-color:transparent;}#mermaid-svg-GXKibZqBb0UK50lc .label text,#mermaid-svg-GXKibZqBb0UK50lc span{fill:#333;color:#333;}#mermaid-svg-GXKibZqBb0UK50lc .node rect,#mermaid-svg-GXKibZqBb0UK50lc .node circle,#mermaid-svg-GXKibZqBb0UK50lc .node ellipse,#mermaid-svg-GXKibZqBb0UK50lc .node polygon,#mermaid-svg-GXKibZqBb0UK50lc .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-GXKibZqBb0UK50lc .rough-node .label text,#mermaid-svg-GXKibZqBb0UK50lc .node .label text,#mermaid-svg-GXKibZqBb0UK50lc .image-shape .label,#mermaid-svg-GXKibZqBb0UK50lc .icon-shape .label{text-anchor:middle;}#mermaid-svg-GXKibZqBb0UK50lc .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-GXKibZqBb0UK50lc .rough-node .label,#mermaid-svg-GXKibZqBb0UK50lc .node .label,#mermaid-svg-GXKibZqBb0UK50lc .image-shape .label,#mermaid-svg-GXKibZqBb0UK50lc .icon-shape .label{text-align:center;}#mermaid-svg-GXKibZqBb0UK50lc .node.clickable{cursor:pointer;}#mermaid-svg-GXKibZqBb0UK50lc .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-GXKibZqBb0UK50lc .arrowheadPath{fill:#333333;}#mermaid-svg-GXKibZqBb0UK50lc .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-GXKibZqBb0UK50lc .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-GXKibZqBb0UK50lc .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-GXKibZqBb0UK50lc .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-GXKibZqBb0UK50lc .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-GXKibZqBb0UK50lc .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-GXKibZqBb0UK50lc .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-GXKibZqBb0UK50lc .cluster text{fill:#333;}#mermaid-svg-GXKibZqBb0UK50lc .cluster span{color:#333;}#mermaid-svg-GXKibZqBb0UK50lc div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-GXKibZqBb0UK50lc .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-GXKibZqBb0UK50lc rect.text{fill:none;stroke-width:0;}#mermaid-svg-GXKibZqBb0UK50lc .icon-shape,#mermaid-svg-GXKibZqBb0UK50lc .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-GXKibZqBb0UK50lc .icon-shape p,#mermaid-svg-GXKibZqBb0UK50lc .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-GXKibZqBb0UK50lc .icon-shape .label rect,#mermaid-svg-GXKibZqBb0UK50lc .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-GXKibZqBb0UK50lc .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-GXKibZqBb0UK50lc .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-GXKibZqBb0UK50lc :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 全部通过
任一步骤失败
部署成功
开发者 push / PR
CI 流水线

lint → test → build
CD 流水线

部署到预发 / 生产
通知开发者修复
生产环境

缩写 全称 做什么
CI Continuous Integration 每次 push/PR 自动 lint + test + build
CD (Delivery) Continuous Delivery 自动部署到预发环境,手动审批上线
CD (Deployment) Continuous Deployment 自动部署到生产环境(无需人工介入)

40.7.2 GitHub Actions 核心概念

GitHub Actions 由四个层次构成:

概念 说明
Workflow .github/workflows/*.yml,定义自动化流程
Event 触发条件:push、pull_request、schedule、手动触发
Job Workflow 中的一个任务单元,可并行运行多个 Job
Step Job 中的每一步操作:运行命令或使用 Action

#mermaid-svg-TgXNacGzz2HZ5VMr{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-TgXNacGzz2HZ5VMr .error-icon{fill:#552222;}#mermaid-svg-TgXNacGzz2HZ5VMr .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-TgXNacGzz2HZ5VMr .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-TgXNacGzz2HZ5VMr .marker{fill:#333333;stroke:#333333;}#mermaid-svg-TgXNacGzz2HZ5VMr .marker.cross{stroke:#333333;}#mermaid-svg-TgXNacGzz2HZ5VMr svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-TgXNacGzz2HZ5VMr p{margin:0;}#mermaid-svg-TgXNacGzz2HZ5VMr .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr .cluster-label text{fill:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr .cluster-label span{color:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr .cluster-label span p{background-color:transparent;}#mermaid-svg-TgXNacGzz2HZ5VMr .label text,#mermaid-svg-TgXNacGzz2HZ5VMr span{fill:#333;color:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr .node rect,#mermaid-svg-TgXNacGzz2HZ5VMr .node circle,#mermaid-svg-TgXNacGzz2HZ5VMr .node ellipse,#mermaid-svg-TgXNacGzz2HZ5VMr .node polygon,#mermaid-svg-TgXNacGzz2HZ5VMr .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-TgXNacGzz2HZ5VMr .rough-node .label text,#mermaid-svg-TgXNacGzz2HZ5VMr .node .label text,#mermaid-svg-TgXNacGzz2HZ5VMr .image-shape .label,#mermaid-svg-TgXNacGzz2HZ5VMr .icon-shape .label{text-anchor:middle;}#mermaid-svg-TgXNacGzz2HZ5VMr .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-TgXNacGzz2HZ5VMr .rough-node .label,#mermaid-svg-TgXNacGzz2HZ5VMr .node .label,#mermaid-svg-TgXNacGzz2HZ5VMr .image-shape .label,#mermaid-svg-TgXNacGzz2HZ5VMr .icon-shape .label{text-align:center;}#mermaid-svg-TgXNacGzz2HZ5VMr .node.clickable{cursor:pointer;}#mermaid-svg-TgXNacGzz2HZ5VMr .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-TgXNacGzz2HZ5VMr .arrowheadPath{fill:#333333;}#mermaid-svg-TgXNacGzz2HZ5VMr .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-TgXNacGzz2HZ5VMr .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-TgXNacGzz2HZ5VMr .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-TgXNacGzz2HZ5VMr .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-TgXNacGzz2HZ5VMr .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-TgXNacGzz2HZ5VMr .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-TgXNacGzz2HZ5VMr .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-TgXNacGzz2HZ5VMr .cluster text{fill:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr .cluster span{color:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-TgXNacGzz2HZ5VMr .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-TgXNacGzz2HZ5VMr rect.text{fill:none;stroke-width:0;}#mermaid-svg-TgXNacGzz2HZ5VMr .icon-shape,#mermaid-svg-TgXNacGzz2HZ5VMr .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-TgXNacGzz2HZ5VMr .icon-shape p,#mermaid-svg-TgXNacGzz2HZ5VMr .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-TgXNacGzz2HZ5VMr .icon-shape .label rect,#mermaid-svg-TgXNacGzz2HZ5VMr .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-TgXNacGzz2HZ5VMr .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-TgXNacGzz2HZ5VMr .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-TgXNacGzz2HZ5VMr :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} Event 触发

push / PR / schedule
Workflow

.github/workflows/ci.yml
Job 1: lint + test
Job 2: build
Step 1: checkout
Step 2: setup Node
Step 3: npm install
Step 4: npm run lint
Step 5: npm run test
Step 1: checkout
Step 2: npm run build

40.7.3 完整 workflow 示例

yaml 复制代码
# .github/workflows/ci.yml
name: CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  lint-and-test:
    name: Lint & Test
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20, 22]
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node ${{ matrix.node-version }}
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: npm

      - name: Install
        run: npm ci        # ci 比 install 更快、更确定

      - name: Lint
        run: npm run lint

      - name: Test with coverage
        run: npm run test:coverage

      - name: Upload coverage
        if: matrix.node-version == 20   # 只在一个版本上传覆盖率
        uses: codecov/codecov-action@v4
        with:
          token: ${{ secrets.CODECOV_TOKEN }}

  build:
    name: Build
    needs: lint-and-test        # build 依赖 lint-and-test 通过
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npm run build
      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: dist
          path: dist/

40.7.4 常用 Action 与 Secrets

Action 用途
actions/checkout 检出代码
actions/setup-node 设置 Node 版本
actions/cache 缓存依赖(加速 install)
actions/upload-artifact 上传构建产物
codecov/codecov-action 上传测试覆盖率

Secrets :在仓库 Settings → Secrets 中配置,workflow 中通过 ${``{ secrets.XXX }} 引用。常用于 API Key、部署 token 等敏感信息------绝不硬编码在 yml 中。

40.7.5 CI/CD 工具对比

工具 优势 劣势
GitHub Actions 与 GitHub 深度集成、免费额度大 私有仓库限额
GitLab CI 一体化 DevOps、自托管 Runner 学习曲线陡
Jenkins 高度可定制、插件生态 配置复杂、维护成本高
CircleCI 配置简洁、并行能力强 免费版限制

GitHub 项目首选 Actions:零配置与代码仓库打通,PR 自动触发、状态显示在 PR 页面,团队成员一眼可见。


40.8 模块打包工具概述:Webpack、Vite、Rollup、esbuild

40.8.1 为什么需要打包工具

浏览器原生只支持单文件脚本(ES2015 之前)或有限的 ES Module 支持。打包工具要解决的问题:

  • 模块合并 :数百个 import/require → 少量文件
  • 语法转换:ES2024 / TypeScript / JSX → 兼容旧浏览器
  • 资源处理:CSS、图片、字体等非 JS 资源的引入与压缩
  • 代码分割:按需加载、懒加载
  • Tree-shaking:移除未使用的导出

40.8.2 Webpack:老牌全能选手

Webpack 是前端打包工具的"鼻祖",以极高的可配置性 和庞大的插件生态著称:

javascript 复制代码
// webpack.config.js
import path from "path";

export default {
  entry: "./src/index.js",
  output: {
    path: path.resolve("dist"),
    filename: "[name].[contenthash].js",    // contenthash 用于长期缓存
    clean: true
  },
  module: {
    rules: [
      { test: /\.css$/, use: ["style-loader", "css-loader"] },
      { test: /\.js$/, use: "babel-loader", exclude: /node_modules/ }
    ]
  },
  plugins: [
    // new HtmlWebpackPlugin({ template: "index.html" })
  ],
  optimization: {
    splitChunks: { chunks: "all" }           // 代码分割
  }
};

Webpack 的定位:大型企业项目的默认选择(Create React App、Vue CLI 底层都基于它),配置项多但生态最完善。新项目如果不是已有框架脚手架,优先考虑 Vite。

40.8.3 Vite:新一代开发体验之王

Vite:基于原生 ES Module 的开发服务器------启动时不做打包,浏览器请求哪个文件就转译哪个文件。构建时使用 Rollup。

shell 复制代码
npm create vite@latest my-app -- --template vanilla
javascript 复制代码
// vite.config.js
import { defineConfig } from "vite";

export default defineConfig({
  root: "src",
  build: {
    outDir: "../dist",
    rollupOptions: {
      input: "src/index.js"
    }
  },
  server: {
    port: 3000,
    open: true
  }
});

Vite 的开发体验优势:

维度 Webpack Vite
冷启动 全量打包(秒~十秒级) 按需转译(亚秒级)
HMR 全量重编译后注入 仅更新变更模块(毫秒级)
预打包 全量 仅预打包 node_modules(esbuild)
配置复杂度 高 低(开箱即用)

40.8.4 Rollup:库打包的首选

Rollup :以 ES Module 为核心、Tree-shaking 效果最好的打包工具。输出体积最小,是发布 npm 库的首选。

javascript 复制代码
// rollup.config.mjs
import { nodeResolve } from "@rollup/plugin-node-resolve";
import commonjs from "@rollup/plugin-commonjs";
import terser from "@rollup/plugin-terser";

export default {
  input: "src/index.js",
  output: [
    { file: "dist/bundle.cjs.js", format: "cjs" },      // CommonJS
    { file: "dist/bundle.esm.js", format: "es" },        // ES Module
    { file: "dist/bundle.umd.js", format: "umd", name: "MyLib" }  // UMD(浏览器 script 标签)
  ],
  plugins: [nodeResolve(), commonjs(), terser()]
};

40.8.5 esbuild:极速打包器

esbuild :用 Go 编写的打包器,速度是 JavaScript 打包器的 10~100 倍。Vite 用它做预打包(预解析 node_modules)。

shell 复制代码
npx esbuild src/index.js --bundle --outfile=dist/out.js --format=esm --minify
javascript 复制代码
// esbuild 的 JavaScript API
import { build } from "esbuild";

await build({
  entryPoints: ["src/index.js"],
  bundle: true,
  outfile: "dist/out.js",
  format: "esm",
  minify: true,
  platform: "browser",
  target: "es2020"
});

40.8.6 四者定位对比

维度 Webpack Vite Rollup esbuild
定位 全能打包器 开发服务器 + Rollup 构建 库打包器 极速打包/转译器
开发启动 慢(全量打包) 快(原生 ESM) 无开发服务器 无开发服务器
Tree-shaking 支持 依赖 Rollup 最佳 基础支持
输出体积 中 小(Rollup) 最小 小
配置复杂度 高 低 中 低
生态成熟度 最成熟 快速增长 库生态首选 作为底层工具
典型用途 大型企业应用 现代 Web 应用首选 发布 npm 库 预打包 / 脚本工具
语言 JavaScript JavaScript JavaScript Go

选型决策树:

  • 新项目(应用) → Vite
  • 发布 npm 库 → Rollup
  • 老项目维护 → Webpack
  • 需要极致速度或作为底层工具 → esbuild

40.9 实战:为工具库搭建完整的工程化体系

本节从零搭建一个名为 my-utils 的工具库,覆盖工程化全链路:ESLint + Prettier 规范 → Jest 单元测试 → Rollup 打包 → husky 门禁 → GitHub Actions CI。

40.9.1 项目初始化与目录结构

shell 复制代码
mkdir my-utils && cd my-utils
npm init -y
复制代码
my-utils/
├── .github/
│   └── workflows/
│       └── ci.yml
├── .husky/
│   ├── pre-commit
│   └── commit-msg
├── src/
│   ├── index.js
│   ├── string.js
│   └── array.js
├── __tests__/
│   ├── string.test.js
│   └── array.test.js
├── dist/
├── eslint.config.js
├── .prettierrc
├── .editorconfig
├── jest.config.js
├── rollup.config.mjs
├── commitlint.config.js
└── package.json

40.9.2 编写工具函数源码

javascript 复制代码
// src/string.js
/**
 * 将字符串首字母大写
 * @param {string} str
 * @returns {string}
 */
export function capitalize(str) {
  if (typeof str !== "string" || str.length === 0) return str;
  return str[0].toUpperCase() + str.slice(1);
}

/**
 * 将驼峰命名转为短横线命名
 * @param {string} str 例如 "firstName"
 * @returns {string} 例如 "first-name"
 */
export function camelToKebab(str) {
  return str.replace(/([A-Z])/g, "-$1").toLowerCase();
}
javascript 复制代码
// src/array.js
/**
 * 按指定 key 对数组分组
 * @param {Array} arr
 * @param {string} key
 * @returns {Object}
 */
export function groupBy(arr, key) {
  return arr.reduce((acc, item) => {
    const k = item[key];
    (acc[k] ??= []).push(item);
    return acc;
  }, {});
}

/**
 * 数组去重(支持对象数组按 key 去重)
 * @param {Array} arr
 * @param {string} [key]
 * @returns {Array}
 */
export function unique(arr, key) {
  if (!key) return [...new Set(arr)];
  const seen = new Set();
  return arr.filter(item => {
    const v = item[key];
    if (seen.has(v)) return false;
    seen.add(v);
    return true;
  });
}
javascript 复制代码
// src/index.js ------ 统一入口
export { capitalize, camelToKebab } from "./string.js";
export { groupBy, unique } from "./array.js";

40.9.3 配置 ESLint + Prettier + EditorConfig

javascript 复制代码
// eslint.config.js
import js from "@eslint/js";
import globals from "globals";
import eslintConfigPrettier from "eslint-config-prettier";

export default [
  { ignores: ["dist/**"] },
  js.configs.recommended,
  {
    languageOptions: {
      ecmaVersion: 2024,
      sourceType: "module",
      globals: { ...globals.browser, ...globals.node, ...globals.jest }
    },
    rules: {
      "no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
      "prefer-const": "error"
    }
  },
  eslintConfigPrettier
];
json 复制代码
// .prettierrc
{
  "semi": true,
  "singleQuote": false,
  "trailingComma": "all",
  "printWidth": 100,
  "endOfLine": "lf"
}
ini 复制代码
# .editorconfig
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

40.9.4 配置 Jest 单元测试

javascript 复制代码
// jest.config.js
export default {
  transform: {
    "^.+\\.js$": "babel-jest"
  },
  testMatch: ["**/__tests__/**/*.test.js"],
  coverageDirectory: "coverage",
  collectCoverageFrom: ["src/**/*.js"]
};
json 复制代码
// babel.config.json(Jest 需要 Babel 转 ESM → CJS)
{
  "presets": [["@babel/preset-env", { "targets": { "node": "current" } }]]
}
javascript 复制代码
// __tests__/string.test.js
import { capitalize, camelToKebab } from "../src/string.js";

describe("capitalize", () => {
  it("首字母大写", () => {
    expect(capitalize("hello")).toBe("Hello");
  });
  it("空串返回空串", () => {
    expect(capitalize("")).toBe("");
  });
  it("非字符串原样返回", () => {
    expect(capitalize(null)).toBeNull();
  });
});

describe("camelToKebab", () => {
  it("驼峰转短横线", () => {
    expect(camelToKebab("firstName")).toBe("first-name");
  });
  it("多个大写字母", () => {
    expect(camelToKebab("backgroundColor")).toBe("background-color");
  });
});
javascript 复制代码
// __tests__/array.test.js
import { groupBy, unique } from "../src/array.js";

describe("groupBy", () => {
  const users = [
    { name: "Tom", role: "admin" },
    { name: "Jerry", role: "viewer" },
    { name: "Bob", role: "admin" }
  ];

  it("按 role 分组", () => {
    const result = groupBy(users, "role");
    expect(result.admin).toHaveLength(2);
    expect(result.viewer).toHaveLength(1);
  });
});

describe("unique", () => {
  it("基本类型去重", () => {
    expect(unique([1, 2, 2, 3])).toEqual([1, 2, 3]);
  });
  it("对象数组按 key 去重", () => {
    const arr = [{ id: 1 }, { id: 2 }, { id: 1 }];
    expect(unique(arr, "id")).toEqual([{ id: 1 }, { id: 2 }]);
  });
});

40.9.5 配置 Rollup 打包

javascript 复制代码
// rollup.config.mjs
import { nodeResolve } from "@rollup/plugin-node-resolve";
import commonjs from "@rollup/plugin-commonjs";
import terser from "@rollup/plugin-terser";

export default {
  input: "src/index.js",
  output: [
    { file: "dist/my-utils.cjs.js", format: "cjs", exports: "named" },
    { file: "dist/my-utils.esm.js", format: "es" },
    { file: "dist/my-utils.umd.js", format: "umd", name: "MyUtils" }
  ],
  plugins: [nodeResolve(), commonjs(), terser()]
};

package.json 中声明多种入口格式,让不同消费方自动选择合适版本:

json 复制代码
{
  "name": "my-utils",
  "version": "1.0.0",
  "main": "dist/my-utils.cjs.js",
  "module": "dist/my-utils.esm.js",
  "browser": "dist/my-utils.umd.js",
  "type": "module",
  "files": ["dist"],
  "exports": {
    ".": {
      "import": "./dist/my-utils.esm.js",
      "require": "./dist/my-utils.cjs.js",
      "default": "./dist/my-utils.umd.js"
    }
  },
  "scripts": {
    "lint": "eslint src/ __tests__/",
    "format": "prettier --write 'src/**/*.js' '__tests__/**/*.js'",
    "test": "jest",
    "test:coverage": "jest --coverage",
    "build": "rollup -c",
    "prepublishOnly": "npm run lint && npm run test && npm run build"
  }
}

40.9.6 配置 Git Hooks + commitlint

shell 复制代码
npm install -D husky lint-staged @commitlint/cli @commitlint/config-conventional
npx husky init
json 复制代码
// package.json 追加
{
  "lint-staged": {
    "*.js": ["eslint --fix", "prettier --write"]
  }
}
javascript 复制代码
// commitlint.config.js
export default { extends: ["@commitlint/config-conventional"] };
shell 复制代码
# .husky/pre-commit
npx lint-staged

# .husky/commit-msg
npx --no -- commitlint --edit "$1"

40.9.7 配置 GitHub Actions CI

yaml 复制代码
# .github/workflows/ci.yml
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: npm
      - run: npm ci
      - run: npm run lint
      - run: npm run test:coverage
      - run: npm run build

40.9.8 完整的工程化流水线

#mermaid-svg-FBm7Y30m6QeLNWcA{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-FBm7Y30m6QeLNWcA .error-icon{fill:#552222;}#mermaid-svg-FBm7Y30m6QeLNWcA .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-FBm7Y30m6QeLNWcA .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-FBm7Y30m6QeLNWcA .marker{fill:#333333;stroke:#333333;}#mermaid-svg-FBm7Y30m6QeLNWcA .marker.cross{stroke:#333333;}#mermaid-svg-FBm7Y30m6QeLNWcA svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-FBm7Y30m6QeLNWcA p{margin:0;}#mermaid-svg-FBm7Y30m6QeLNWcA .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA .cluster-label text{fill:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA .cluster-label span{color:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA .cluster-label span p{background-color:transparent;}#mermaid-svg-FBm7Y30m6QeLNWcA .label text,#mermaid-svg-FBm7Y30m6QeLNWcA span{fill:#333;color:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA .node rect,#mermaid-svg-FBm7Y30m6QeLNWcA .node circle,#mermaid-svg-FBm7Y30m6QeLNWcA .node ellipse,#mermaid-svg-FBm7Y30m6QeLNWcA .node polygon,#mermaid-svg-FBm7Y30m6QeLNWcA .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-FBm7Y30m6QeLNWcA .rough-node .label text,#mermaid-svg-FBm7Y30m6QeLNWcA .node .label text,#mermaid-svg-FBm7Y30m6QeLNWcA .image-shape .label,#mermaid-svg-FBm7Y30m6QeLNWcA .icon-shape .label{text-anchor:middle;}#mermaid-svg-FBm7Y30m6QeLNWcA .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-FBm7Y30m6QeLNWcA .rough-node .label,#mermaid-svg-FBm7Y30m6QeLNWcA .node .label,#mermaid-svg-FBm7Y30m6QeLNWcA .image-shape .label,#mermaid-svg-FBm7Y30m6QeLNWcA .icon-shape .label{text-align:center;}#mermaid-svg-FBm7Y30m6QeLNWcA .node.clickable{cursor:pointer;}#mermaid-svg-FBm7Y30m6QeLNWcA .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-FBm7Y30m6QeLNWcA .arrowheadPath{fill:#333333;}#mermaid-svg-FBm7Y30m6QeLNWcA .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-FBm7Y30m6QeLNWcA .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-FBm7Y30m6QeLNWcA .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-FBm7Y30m6QeLNWcA .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-FBm7Y30m6QeLNWcA .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-FBm7Y30m6QeLNWcA .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-FBm7Y30m6QeLNWcA .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-FBm7Y30m6QeLNWcA .cluster text{fill:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA .cluster span{color:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-FBm7Y30m6QeLNWcA .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-FBm7Y30m6QeLNWcA rect.text{fill:none;stroke-width:0;}#mermaid-svg-FBm7Y30m6QeLNWcA .icon-shape,#mermaid-svg-FBm7Y30m6QeLNWcA .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-FBm7Y30m6QeLNWcA .icon-shape p,#mermaid-svg-FBm7Y30m6QeLNWcA .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-FBm7Y30m6QeLNWcA .icon-shape .label rect,#mermaid-svg-FBm7Y30m6QeLNWcA .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-FBm7Y30m6QeLNWcA .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-FBm7Y30m6QeLNWcA .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-FBm7Y30m6QeLNWcA :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 通过
通过
全部通过
开发者 git commit
husky pre-commit
lint-staged

ESLint --fix

Prettier --write
husky commit-msg
commitlint 校验格式
git push
GitHub Actions CI
npm run lint
npm run test:coverage
npm run build
npm publish

(prepublishOnly)

40.9.9 验证与发布

shell 复制代码
# 本地验证
npm run lint           # ESLint 检查
npm run test:coverage  # 测试 + 覆盖率
npm run build          # 打包到 dist/

# 发布前检查
npm publish --dry-run  # 预览发布内容

# 正式发布
npm publish
检查项 工具 通过标准
代码规范 ESLint 0 errors
代码格式 Prettier 全部文件一致
单元测试 Jest 全部 pass,覆盖率 ≥ 90%
构建产物 Rollup 三种格式(cjs/esm/umd)均可生成
commit 规范 commitlint feat/fix/docs 等标准 type
CI GitHub Actions lint + test + build 全绿
发布 npm publish prepublishOnly 自动触发全链路检查

发布后的维护 :每次修改代码前,先在本地跑 npm run lint && npm run test;PR 触发 CI 自动检查;合并到 main 后手动 npm version patch + npm publish,或使用 semantic-release 全自动发布。


总结

#mermaid-svg-sMoEA1YNXHiHPwhk{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-sMoEA1YNXHiHPwhk .error-icon{fill:#552222;}#mermaid-svg-sMoEA1YNXHiHPwhk .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-sMoEA1YNXHiHPwhk .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-sMoEA1YNXHiHPwhk .marker{fill:#333333;stroke:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk .marker.cross{stroke:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-sMoEA1YNXHiHPwhk p{margin:0;}#mermaid-svg-sMoEA1YNXHiHPwhk .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster-label text{fill:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster-label span{color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster-label span p{background-color:transparent;}#mermaid-svg-sMoEA1YNXHiHPwhk .label text,#mermaid-svg-sMoEA1YNXHiHPwhk span{fill:#333;color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .node rect,#mermaid-svg-sMoEA1YNXHiHPwhk .node circle,#mermaid-svg-sMoEA1YNXHiHPwhk .node ellipse,#mermaid-svg-sMoEA1YNXHiHPwhk .node polygon,#mermaid-svg-sMoEA1YNXHiHPwhk .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .rough-node .label text,#mermaid-svg-sMoEA1YNXHiHPwhk .node .label text,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape .label,#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape .label{text-anchor:middle;}#mermaid-svg-sMoEA1YNXHiHPwhk .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .rough-node .label,#mermaid-svg-sMoEA1YNXHiHPwhk .node .label,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape .label,#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape .label{text-align:center;}#mermaid-svg-sMoEA1YNXHiHPwhk .node.clickable{cursor:pointer;}#mermaid-svg-sMoEA1YNXHiHPwhk .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk .arrowheadPath{fill:#333333;}#mermaid-svg-sMoEA1YNXHiHPwhk .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-sMoEA1YNXHiHPwhk .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-sMoEA1YNXHiHPwhk .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-sMoEA1YNXHiHPwhk .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-sMoEA1YNXHiHPwhk .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-sMoEA1YNXHiHPwhk .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster text{fill:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk .cluster span{color:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-sMoEA1YNXHiHPwhk .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-sMoEA1YNXHiHPwhk rect.text{fill:none;stroke-width:0;}#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape p,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-sMoEA1YNXHiHPwhk .icon-shape .label rect,#mermaid-svg-sMoEA1YNXHiHPwhk .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-sMoEA1YNXHiHPwhk .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-sMoEA1YNXHiHPwhk .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-sMoEA1YNXHiHPwhk :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 第40章:JavaScript 工程化实践
代码质量
自动化门禁
测试体系
交付与打包
实战
ESLint 配置与自定义规则 / Prettier / EditorConfig
husky + lint-staged / commitlint
Jest 单元测试 / Playwright E2E 测试
GitHub Actions CI/CD / Webpack·Vite·Rollup·esbuild
工具库 my-utils 全流程工程化

知识点 核心内容
工程化四层 代码规范 → 自动化门禁 → 测试体系 → 交付与部署
ESLint AST 静态分析,flat config(v9+),规则 off/warn/error 三级
ESLint 自定义规则 访问者对象 + AST 节点匹配 + context.report
Prettier 格式化风格问题,与 ESLint 用 eslint-config-prettier 共存
EditorConfig 跨编辑器统一基础格式(缩进、行尾、字符集)
husky 让 Git Hooks(pre-commit / commit-msg)可团队共享
lint-staged 只对暂存文件执行 lint/format,提速大项目
commitlint 强制 conventional commit message 格式
Jest 单元测试 describe/it/expect,toBe vs toEqual,Mock 三种方式
Jest 异步测试 async/await + expect,mockResolvedValue / mockRejectedValue
Playwright 多浏览器、自动等待、Trace 回放,现代 E2E 首选
Cypress 实时重载、时间旅行调试,中小型项目适用
CI/CD 持续集成(lint+test+build)→ 持续交付/部署
GitHub Actions workflow / event / job / step 四层结构
Webpack 全能打包器,企业级大项目默认
Vite 原生 ESM 开发服务器 + Rollup 构建,新项目首选
Rollup ES Module 库打包首选,Tree-shaking 最佳
esbuild Go 编写,10~100 倍速,用于预打包与脚本工具
实战 my-utils 全流程:ESLint + Prettier + Jest + Rollup + husky + CI

关键原则:

  • 工程化的核心是"一次配置、永久受益"------前期投入换来团队长期的质量保障与效率提升
  • ESLint 管逻辑、Prettier 管风格 :职责分离,用 eslint-config-prettier 消除冲突
  • Git Hooks 是最后一道本地门禁 :husky + lint-staged + commitlint 三件套让坏代码"提不上去"
  • 单元测试遵循 FIRST 原则(快、隔离、可重复、自验证、及时),覆盖率 ≥ 90% 但不追求 100%
  • toBe 用 ===,toEqual 深度比较------对象用 toEqual,基本类型用 toBe
  • Mock 的三种方式各有所长:jest.fn()(回调)、jest.mock()(模块隔离)、jest.spyOn()(监听不改行为)
  • E2E 测试数量应远少于单元测试------只在关键用户路径上部署
  • GitHub Actions 与代码仓库深度集成,GitHub 项目首选
  • 打包工具选型:应用用 Vite,库用 Rollup,老项目 Webpack,极致速度 esbuild
  • package.json 的 exports 字段是 npm 库对外暴露多格式入口的标准方式

下篇预告 :第41章:性能优化实战 --- 下篇我们将学习 性能优化实战------从浏览器渲染流程(DOM → CSSOM → Layout → Paint → Composite)开始,深入重排重绘的触发与避免、JavaScript 内存管理与垃圾回收、代码分割与懒加载、虚拟滚动、防抖节流,解读 Web Vitals 核心指标(LCP、FID、CLS),并在 Chrome DevTools Performance 面板中实战分析首屏加载优化全流程。


作者 :xhmico | CSDN 博客 :https://blog.csdn.net/xhmico

参考资源 :The Modern JavaScript Tutorial | MDN Web Docs | ECMAScript 规范

相关推荐
彩虹暴龙兽2 小时前
JavaScript 预编译机制与执行上下文构建分析
javascript
吃我一窝jio2 小时前
Java Bug复盘与性能优化实战
java·开发语言·笔记
tryCbest2 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2733 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
bai2733 小时前
同一个 1.005,toFixed 给 1.00、Math.round 给 1、Intl 给 1.01:999 个三分位小数的实测
javascript·后端
爱编程的173 小时前
一篇讲透 JS 对象:数据类型、原型链与包装类
javascript
Evand J4 小时前
【MATLAB例程】基于APF的多无人机动态路径规划与避障仿真。避碰及安全性能分析。附完整代码的下载链接
开发语言·matlab·无人机
鲸渔4 小时前
【AI Agent系列课程13-Python 基础13】JSON 读写:结构化数据交换基础
开发语言·python·json·ai编程
Highcharts.js9 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图