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() |
toBevstoEqual: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 规范