浏览器兼容性与 Polyfill 技术

开发者通常在最新的浏览器上进行开发，以使用最新的 JavaScript 语法，浏览器接口，让工作更有效率，代码质量更高，更不容易过时。

而用户则可能仍然在使用旧版的浏览器。比如，某些政府教育系统仍然在使用 Windows XP，用户能安装的最新的浏览器是 Chrome 49。有些用户可能只是没有升级浏览器的习惯，导致他们的 Chrome 还是 86 版本。

为了平衡两方面，开发者通常会借助一些工具，自动转译语法，并 Polyfill 新的接口，以兼容某个特定版本的旧浏览器。通过语法分析，按需插入 core-js 中的 Polyfill 代码。而 core-js 缺少的部分，可以用 polyfill-service 补全。

ES 语法转译

Optional Chaining 这种比较新的 ES 语法在老版本浏览器无法支持，运行时会报错。

const dogName = adventurer.dog?.name;

为了兼容旧版浏览器，必须在构建过程中就将其转译成 ES5/ES3 语法。

var _adventurer$dog;
const dogName = (_adventurer$dog = adventurer.dog) === null || _adventurer$dog === void 0 ? void 0 : _adventurer$dog.name;

转译功能通常由 babel，swc，esbuild 等 JavaScript 转译工具提供。

ES 特性 Polyfill

Promise，Stream 等特性需要插入特定的 Polyfill 代码。

esbuild 无法自动分析并 Polyfill 特性，只能手动导入。而 swc 和 babel 可以自动分析源码，按需自动导入。swc 和 babel 都是基于 core-js 进行 polyfill。

浏览器特性 Polyfill

core-js 只提供 ES 特性的 Polyfill（准确的说，是浏览器和 Node.js 交集的部分）。但是浏览器除了 ES 标准外，还提供其他浏览器特有的特性，比如 ResizeObserver。这就需要一个补充方案。

方案1是手动取导入 Polyfill 代码，比如在项目中 import 'whatwg-fetch' 就可以支持 fetch() 接口。但是这对开发者而言是一个比较大的负担。

方案2是在页面中引用 polyfill.io 的脚本，服务器会根据 UA 判断需要加载哪些 Polyfill 代码。开发者也可以用 polyfill-service 自建服务器。缺点是增加了一些服务器开销，也会阻塞应用本体脚本的加载，造成一些成本提高和性能损失。

CSS 语法转译

很多 CSS 特性在未成为正式标准之前便已经被浏览器支持了。但是在这个成为标准的过程中，CSS 特性的提案可能会修改。浏览器厂商为了防止自己目前的实现与之后的正式标准冲突，会在选择器和属性名之前，加上自己的前缀，Firefox 是 -moz-，Chrome 和 Safari 是 -webkit-，而 IE 是 -ms-。

比如下面这段代码：

:fullscreen {
}

为了兼容不同的浏览器，尤其是老浏览器，需要转译成：

:-webkit-full-screen {
}
:-ms-fullscreen {
}
:fullscreen {
}

转译过程主要通过 postcss 实现。当前流行的前端应用构建工具，比如 create-react-app, vite, parcel, 都集成了 postcss。

横向对比

工具	babel	esbuild	swc	polyfill service	postcss
ES 语法转译	✅	✅	✅
ES 特性 Polyfill	✅		✅	✅
浏览器特性 Polyfill				✅
CSS 语法转译					✅

总结

综合来看，目前没有一种技术能够单独达成全自动的浏览器兼容性。建议使用 babel + polyfill service + postcss 之类的融合方案。

当使用一种新特性时，可以先查一下 caniuse.com 支持的浏览器版本。如果需要 Polyfill，要看自己选用的 Polyfill 方案（core-js，polyfill-service）是否支持。如果不支持，则需要手动 Polyfill 这个特性。

实践

Create React App

以 create-react-app 项目为例。首先我们需要配置项目支持的浏览器版本，让底层的 babel 和 postcss 将 JS 和 CSS 转译到目标浏览器支持的语法，并尽可能注入所需的 Polyfill 代码：

{
  "browserslist": {
    "production": [
      "chrome > 49",
      "firefox > 53",
      "ie 11"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  }
}

然后，我们需要修改 HTML 模板，注入 Polyfill.io 的脚本，以支持额外的 Polyfill 特性：

<!DOCTYPE html>
<html lang="en">
  <head>
    <script src="https://polyfill.io/v3/polyfill.min.js"></script>
  </head>
  <body>
    ...
  </body>
</html>

Vite

Vite 默认只支持 Chrome 87+，这个要求对大部分实际应用可能太过苛刻。如果要支持更早的浏览器，则必须使用 legacy 插件：

import react from '@vitejs/plugin-react';
import legacy from '@vitejs/plugin-legacy';
import { defineConfig } from 'vite';

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    react(),
    legacy({
      targets: [
        "chrome > 49",
        "firefox > 53",
        "ie 11"
      ],
    }),
  ],
});

然后，我们需要修改 HTML 模板，注入 Polyfill.io 的脚本，以支持额外的 Polyfill 特性：

<!DOCTYPE html>
<html lang="en">
  <head>
    <script src="https://polyfill.io/v3/polyfill.min.js"></script>
  </head>
  <body>
    ...
  </body>
</html>

2022年 12月 5日 | 评论

扒一扒深圳外企的前端/全栈招聘

最近找工作接触过的一些深圳外企。

Artflow AI（远程）

职位：全栈。

来源：猎头。

流程：

HR 直接拉了一个群，初创公司，CEO 和 CTO 都是华人。
技术笔试，做一个全栈 demo, 重视单元测试。
技术面试，中文，两个面试官分别是 CTO （算法/架构）和全栈开发。问的都是一些实际项目的问题，没有很偏门很细节的问题。
综合面试，英文，两个面试官分别是 CEO 和另外一个 Co-Founder。主要问项目经历，以及对这个公司做的产品有什么想法和建议。
谈薪资待遇（最后没谈拢）。

优点：

不用八股文，不用刷题。
流程很快，从递简历到拿 offer 一周时间。
全员远程，灵活办公。
可以谈 14 薪，比 16 薪或 18 薪要保险一点。

缺点：

试用期三个月，发正式工资的 80%。
公积金 7%。
因为时差的原因，开会时间是中国的晚上 9 点到 11 点。

SkyScanner

职位：全栈。

来源：LinkedIn。

流程：

HR 电话。
待续。

亚马逊 AWS

职位：前端架构（偏全栈）。

来源：LinkedIn。

流程：

HR 电话，没啥特别的。
技术面试1，主要是介绍自己做过的项目，不会问技术细节问题。
技术笔试，做一个全栈的系统 demo （技术栈不限）。要用到至少一种 AWS 服务，最常用的是 S3，要实际部署到 AWS 上运行，还要写系统架构设计报告，比较耗时。我觉得他们的岗位描述有问题，笔试全是全栈+运维的东西，前端的比例很少。
技术面试2，要求做 PPT 介绍笔试题目的系统设计。我到这一步就被通知招聘冻结了，没有后续了。

优点：

不用八股文。
不用刷题。
薪资水平在外企中算高的。

缺点：

做 demo 比较耗时，前后搞了一周的时间。主要是 AWS 比较难搞，之前的工作都是有专门的运维搞AWS, 开发是不会直接去操作的。
突然终止招聘不太靠谱啊，可能很长一段时间都没岗位了。
开发也要求走客户，出差可能会比较多。

Flexport

职位：全栈。

来源：公司官网。

流程：

HR 电话，聊完之后说安排面试但又没有后续了。

缺点：

HR 不靠谱。
薪资的现金部分比阿里低，期权妥妥的废纸。

Nike

职位：全栈。

来源：脉脉。

流程：

HR 面试，有英文口语部分。
技术笔试，做一个全栈 demo, 技术栈不限，重点要求单元测试和 CI （GitLab）。
技术面试，有英文口语部分，不涉及笔试 demo 的内容，也没有问技术细节，主要介绍项目经历和个人发展的问题。
HR 沟通职级和薪资，因为降薪太多，就没继续了。

优点：

不用八股文。
不用刷题。
面试过程比较轻松友好。

缺点：

薪资比较低。
要对接 Nike 收购的数据公司，可能要处理一堆技术债务。

避坑

国内小厂：不要相信小而美。
假外企，假国企：都是大厂出来的，比大厂还能卷。

总结

我个人是比较喜欢偏实践的面试/笔试的，毕竟啥 service worker 啥 event loop 的技术细节，工作中也是随用随搜，工作中 99% 用不到。面试的大部分都是全栈或者前端偏全栈，在做 demo 的过程中我会尝试一些新的技术，比如 Vitest, Adonis, 还是很有收获的，比每天上班重复那一套东西要有趣。

技术上，纯前端不多，大部分是全栈。前端 React 还是比较通吃，有些公司用 Vue，不建议学 Angular 了。后端 Node.js, Python, Java 比较多，但是面试很多不限制编程语言，可以后面再转。除了基本的功能实现，单元测试基本上每家都会考一下。另外 CI, 云服务，也是常会遇到的。笔试考 demo 的好处是可以边做边学，不用事先背一大堆可能用不到的东西。

外企的薪资普遍比较低。薪资高的要么是亚马逊这样的大厂，要么是搞区块链的不差韭菜。阿里的开发 P6 英文叫 Software Engineer II, 对应到其他外企同级别的岗位一般也叫这个，再上面是 Senior Software Engineer 和 Lead Software Engineer。但是普通外企的 Software Engineer II 的年薪也就是阿里开发 P5 的水平，甚至 Nike 这种 Senior Software Engineer 也给不到阿里 P6 的水平。

但是另一方面，大部分外企的评价体系决定了他们是真的闲。有项目就做项目，没项目就自行安排。不会像国内大厂一样，盲目上项目堆人力，做十个烂九个。开会没完没了，对接数不清的人。国内大厂的小领导们，带着下属疯狂卷影响力，对公司业务和个人成长基本是负作用。这种又累又绝望的感觉，让我觉得工资低一些的外企也变香了。

继续找。

2022年 11月 20日 | 评论

下一代前端构建工具

2022 年，Webpack + Babel + Terser 仍然是前端项目构建工具的主流，广泛用于各种生产环境。不可否认，Webpack 和 Babel 仍然在持续进化，对各类研发提供了最稳定且全面的支持。但是随着前端项目规模的增长，CI 流水线的普及，构建性能问题已经成为了影响开发效率的一个关键因素。下一代构建工具，试图从不同的角度实现对构建效率的提升。

esbuild

用 Go 语言实现的构建工具，提供了编译，打包，压缩能力。由于是原生程序，且几乎不依赖第三方库，充分利用 CPU 多核架构等原因，esbuild 实现了夸张的毫秒级编译速度，效率数百倍于 Webpack + Babel。

优点：

高性能。目前最快的实现，整体上略优于 swc。
低占用。Go 语言对字符串的内存优化很好，即使采用多线程工作方式，内存占用仍然远低于基于 Webpack 的工具。

缺点：

自身不提供 HMR，需要依赖其他工具实现。
不支持 React Refresh，对 React 的 HMR 不能用 webpack-dev-server + esbuild 编译的方案。
产物代码分割功能仍处在实验阶段，相比 Webpack 和 Rollup 还是比较简单，不太可靠。
插件生态不健全。

适用场景：

纯 JS 库构建。不需要 HMR，只需要 watch 能力。
Node.js 后端应用构建。不需要 HMR，只需要 watch 能力。
Jest 和 SSR 等 Node 运行环境的代码转译。
嵌入其他构建工具。比如 Vite 用了 esbuild 的编译和压缩能力，不足的部分用 Rollup 插件体系和自己实现的 HMR 补全。

swc

用 Rust 语言实现的构建工具，swc 实现了编译和压缩能力，swcpack 实现了打包能力（实验性）。swc 设计之初就是完全对标 Babel 的，相比 esbuild 拥有更广泛的适用场景。

优点：

高性能。实际测试略慢于 esbuild，但也比 webpack+babel+terser 快上几十倍。
支持 React Refresh。这一点是对 esbuild 的巨大优势，且短期内 esbuild 无法克服的问题。

缺点：

自身不提供 HMR，需要依赖其他工具实现。
打包能力还是实验性质，缺乏高级配置支持。
插件生态不健全，用 Rust 编写插件门槛较高。

适用场景：

纯 JS 库构建。不需要 HMR，只需要 watch 能力。
Node.js 后端应用构建。不需要 HMR，只需要 watch 能力。
Jest (@swc/jest) 和 SSR 等 Node 运行环境的代码转译。
嵌入其他构建工具。比如 Parcel 用了 swc 的编译和压缩能力，不足的部分用自己实现的 HMR 补全，并有 Parcel 自己的插件体系。

Vite

基于 esbuild 的编译和压缩能力，Bundleless 的 HMR 实现，并用 Rollup 插件生态补足了常用的打包特性。目前性能和特性综合考量的最佳选择。

更早的 Bundleless 实现 Snowpack 已经泯然众人了。Bundleless 最大的问题在于，现在前端应用的依赖树太深太广，模块文件太多，逐个文件加载导致启动速度极其缓慢。而 Vite 则是融合了 Bundle 和 Bundleless 两种策略，对 node_modules 还是用 esbuild 去快速 bundle，一次性加载，对于源码再采用 bundleless 策略。这样就平衡了启动速度和热加载速度。

优点：

构建速度更快
热更新速度更快
能够使用众多的 Rollup 插件

缺点：

由于 esbuild 不支持 React Refresh，React 项目还是要走 Babel，一定程度上拖慢了速度。
Rollup 及其插件生态还是以 JS 为主，性能优化空间有限。Vite 作者寄希望于 esbuild 打包能力和插件生态成熟，用 esbuild 替换掉 Rollup。

适用场景：

Web 前端应用
浏览器插件
Electron 应用
小程序

Parcel 2

Parcel 基于 swc 并有自己的 HMR 和插件生态。设计上与 Vite 类似，但 Parcel 自研部分更多，而 Vite 依赖且受限于 Rollup。性能上 Parcel 甚至更快一些，尤其是缓存性能，热启动极快。但在稳定性上 Parcel 控制的并不好，一个最简单的 React 应用都需要一些 hack 才能工作。

优点：

构建速度快
缓存效率高
热更新速度快

缺点：

不兼容 pnpm
插件生态不足

适用场景：

Web 前端应用
浏览器插件
Electron 应用
小程序

Turbopack(Alpha)

用 Rust 实现 Webpack 替代，工作原理和 Webpack + Webpack Dev Server 保持一致，而没有走时下流行的 bundleless 路线。当项目源码（不包括 node_modules）文件数量达到数千，Vite 启动速度会随文件数量降低，即使本地几乎不存在网络延迟，数以千计的 HTTP 请求以及代码转译任务仍然耗时不菲。而 Turbopack 则通过提升打包性能，在保持 Webpack 工作方式的情况下，实现了快速启动和 HMR。当前 Turbopack 的测试性能是领先 Vite 的。

假如 Vite/Parcel 也用 Rust/Go 完全重写，那么 Vite/Parcel 和 Turbopack 应该具有以下关系：

在文件数量小于 N 时，Vite/Parcel 的冷启动速度更快，但是 Turbopack 也足够快。
在文件数量大于 N 时，Turbopack 的冷启动速度更快，且于 Vite/Parcel 的差距越来越大。
Vite/Parcel 的 HMR 速度总是快于 Turbopack，但是两者都足够快，以至于差异肉眼无法分辨。

可惜 Turbopack 目前并没有推出正式版本，完全没有达到 Vite/Parcel 的成熟度，因此完全没有可比性。目前只能关注，深入分析或评测意义不大。

2022年 10月 28日 | 评论

JavaScript 十进制库选型

众所周知，计算机以二进制存储数字，而真实世界中用十进制表示数字。二进制和十进制的差异可以用一个乍看非常怪异的例子说明：

> 0.1 + 0.2
0.30000000000000004

不管是 JavaScript, Python 还是 Java，都能够得到类似的结果。

分析原因，就像十进制中的 1/3 是无限循环小数，二进制中的 1/10 和 1/5 也是无限循环小数。计算机的基本数字类型都是有精度限制的。两个无限循环小数相加，导致精度损失，产生了 0.30000000000000004 这样的结果。

在很多情况下，这个并不会有实际影响。因为十进制同样有精度误差，十进制并不比二进制更精确。它真正导致的问题是违反直觉。对于人直接可见的数字计算，比如购物车结算总价，出现二进制精度问题显然会让不了解二进制原理的普通用户感到诧异。

另外，原生浮点数的取整方法都是四舍五入。按照统计学规律，大量累加起来，总数会偏大。对于电商，银行和支付系统，会导致交易的某一方长期多付出，是违反公平的。因此这些系统常常采用银行家算法（四舍六入五成双）。

最后，整数和浮点数都有固定的精度限制，且受限于硬件或编译器无法更改。计算超出范围的大数会出错，不安全。

基于这三点原因，在电商和金融系统中，会使用十进制类而非基本数据类型来计算和存储交易数字。

JS 常用库比较

JavaScript 目前仍然没有原生的十进制类。我们只能从一些提供十进制类的 NPM 包中选择。不同的十进制库提供的功能不完全相同。通常功能越多体积越大。目前开发比较活跃且比较流行的 JS 库都来自同一位作者。差异详见此处。

NPM 包	big.js	bignumber.js	decimal.js
打包尺寸 Minified + Gzipped	2.9kB	8.1kB	12.3kB
精度控制	N位小数	N位小数	N位有效数字
除法精度损失	有损	有损	有损
加、减、乘法精度损失	无损	无损	有损
超大数	支持，计算较慢	支持，计算较快	支持，计算较快
超小数	支持，计算较慢	支持，计算较慢	支持，计算较快
舍入模式	ROUND_DOWN ROUND_HALF_UP ROUND_HALF_EVEN ROUND_UP	ROUND_UP ROUND_DOWN ROUND_CEIL ROUND_FLOOR ROUND_HALF_UP ROUND_HALF_DOWN ROUND_HALF_EVEN ROUND_HALF_CEIL ROUND_HALF_FLOOR	ROUND_UP ROUND_DOWN ROUND_CEIL ROUND_FLOOR ROUND_HALF_UP ROUND_HALF_DOWN ROUND_HALF_EVEN ROUND_HALF_CEIL ROUND_HALF_FLOOR EUCLID
指数计算	支持	支持	支持
对数计算	不支持	不支持	支持
复数计算	不支持	不支持	支持
三角函数计算	不支持	不支持	支持

从简单到复杂排列：big.js < bignumber.js < decimal.js

从打包体积来看，big.js 最小，在浏览器端占据优势。

在电商和金融场景，更常见的精度控制方法是控制 N 位小数，big.js 和 bignumber.js 更加合适。而在科学计算和工程领域，可能 decimal.js 的控制 N 位有效数字的特性会更合适一些。

除法都是有精度损失的，这是无法避免的。但是 decimal.js 的加减乘法也有精度损失，这一点需要注意。

big.js 对于超大数的计算会比 bignumber.js 或 decimal.js 慢，要结合具体场景分析是否会性能瓶颈。在前端/客户端场景，或者小型电商后端，计算量很小，且大数不常见，那么 big.js 完全可以胜任。在大型电商平台和金融交易后端，大数计算量繁重，那么 bignumber.js 会更好一些。科学和工程领域需要的超大数计算，则 decimal.js 会更合适。（但是这些领域通常也不会用 JS 这么慢的语言，所以 decimal.js 的定位有点尴尬）

超小数通常只在金融，科学和工程领域出现，这种数据的计算 decimal.js 会比 big.js 和 bignumber.js 快。和上面的大数应用场景分析类似，要视情况选择。

默认的舍入模式都是四舍五入（ROUND_HALF_UP），且都支持银行家算法——四舍六入五成双（ROUND_HALF_EVEN）。对于大多数电商和金融场景都足够用了。

decimal.js 还支持对数，复数，三角函数等高级数学运算。

按应用场景选择

中小型电商

中小型电商的交易数字都偏小，big.js 在前后端都可以胜任，满足精度控制，舍入模式和性能的需求。同时 big.js 的体积较小，有利于优化前端传输速度。

大型电商平台和金融系统

前端/客户端通常只处理单一客户的计算需求，大数出现频率较少，通常不存在性能问题。 big.js 依然可以胜任。

后端则可能会频繁处理大数，这时候 bignumber.js 会更快一些。但是，这种情况通常表明整个系统都面临性能问题，更加实际的做法是将重度计算的服务用 Java 之类的更高性能语言重构……

科学计算和工程领域

decimal.js 功能更加丰富，对极大和极小数计算的性能更好，比 big.js 和 bignumber.js 更合适。

但是，这些领域通常对性能要求很高，用 JS 的情况非常少见。建议直接使用一种更合适的语言……

总结

前端选择 big.js 一般都没错。它简单小巧，却又能提供所有我们需要的功能。

后端 Node.js 不需要考虑打包尺寸，如果有比较多的大数计算量，也可以上 bignumber.js 的。

decimal.js 的定位则比较尴尬，除非你特别需要某些科学计算功能，否则没有必要选它。

实践

阿里巴巴 Fusion Design 从 bignumber.js 切换到 big.js PR 链接

2022年 6月 18日 | 评论

前端最佳实践：字体

字体单位

px 依旧是最全面的选择，尤其是重交互的网站：

能够做到设计稿的像素级还原。
用户体验统一，变量少，可控。
方便配合 JS 动态计算布局，JS 接口通常只能获取像素为单位的尺寸和位置。
icon，图片和 border 通常都是使用像素尺寸，字体采用像素单位更容易配合。

rem 在文字内容型网站上更加灵活，适合新闻，博客等：

自适应不同设备，不同用户偏好，获得最佳阅读体验。
无需手写繁复的 media query。

有些创意内容网站使用 vw 尺寸系统，字体和图片总是同窗口比例缩放，以实现类似海报布局的整体感，但也仅限于这一类型的网站。

em 和 % 会用在局部使用，但存在嵌套后尺寸不容易控制的问题，极少在项目中大范围使用。

pt 是印刷常用单位，不适合现如今的 Web 环境，且和 px 对应关系复杂，应该避免。

正文字体大小

12px 是 Chrome 浏览器默认支持显示的最小字体。即使 CSS 设置了 9px，最终用户看到的仍然是 12px 字体。因此在设计中使用小于 12px 的字体是一个严重的错误。12px 的英文字体可读性尚可，但是中文可读性比较差。建议作为次要文本字体的尺寸。

13px 是信息密度较高，中文可读性尚可的选择。比如 Facebook 和百度用的就是 13px。

14px 是信息密度和中文可读性的一个比较好的平衡点，适合界面复杂且空间比较紧张的网站的正文字体大小。比如

16px 是大部分浏览器的默认字体大小，可读性好，但是信息密度不高，适合一般网站。

18px 以上通常只有在创意营销网站上才会作为正文字体大小使用。

一个比较通用的策略是：

12px：次要文字，页脚链接，标签分类，面包屑，输入框提示，小按钮，小输入框
14px：普通文字，正文，输入框，按钮
16px：突出文字，卡片标题，大按钮，搜索栏

标题层级字体大小

HTML 支持 H1 到 H6 共六级标题。但实际应用中，我们应当控制标题的层级数量，层级越多，使用体验会越差。

功能为主的网站对标题依赖比较小，更多是靠 Card 和 Tab 等容器进行界面层级管理。

内容型网站对标题层级的需求会更高一些，但也尽量不超过三级。

H1 字体大小取决于网站类型对信息密度的要求。以功能为主的系统通常 H1 会比较小，不会超过 40px。

H1, H2, H3 之间应当有 30% 左右的递减，视觉上差异才够显著。比如：

H1, 36px：页面标题
H2, 24px：章节标题
H3, 16px：子章节标题，卡片标题，弹窗标题

字重

最早字体只支持两种字重，正常（normal, 400）和粗体（bold, 700）。现代 Web 字体的字重支持 100 到 900 等 9 种字重，100 最细，900 最粗。但是系统字体支持的字重数量通常较少。

Windows 默认中文字体“雅黑”支持 300, 400 和 700 三种字重。macOS 和 iOS 默认中文字体“苹方”支持 100/200/300/400/500/600 六种字重（苹果更喜欢使用较细的字体设计）。也就是说“苹方”的粗体，会比“雅黑”要细一些。Android 系统默认字体 Noto Sans CJK 支持 200/300/400/500/700/900 六种字重，最为全面。部分 Android 系统，比如魅族 Flyme 和小米 MIUI，甚至搞出了字重的无极调节。

由于中文字体体量巨大，通常网站不会加载远端中文字体，而是使用系统字体。因此，在使用字重的时候，就需要考虑系统字体的字重支持。综合主流操作系统，得出兼容性最好的字重集合：细体 300，正常 400，粗体 700/600。

2022年 4月 5日 | 评论

变更日志 Changelog 的书写方法

变更日志（Changelog）是软件工程中的一种常用手段，用于记录每个软件版本所发生的变更。一方面，可以方便下游及时兼容；另一方面，让协作开发者和用户了解项目进展。变更日志需要打版本号，但并不一定要遵循 Semantic Versioning。

最简单的形式

推荐使用 Markdown 语法，文件名为 CHANGELOG.md。
用二级标题标记版本号，建议标注发布日期，以便日后回溯。合并主干分支但尚未发布的，用“未发布”标题，放在开头。
对于不兼容的变化，用“破坏性变更”标记。

# 变更日志

## 未发布

- 修复 Button

## 2.0.0 - 2021-09-17

- **破坏性变更**: Table 组件重命名为 Grid

## 1.1.0 - 2021-03-21

- Card 组件支持 size (small/large/medium)
- 新增 List 和 Table 组件

## 1.0.0 - 2021-02-08

- 新增 Card 组件
- 新增 Button 组件

增加模块标记

对于模块比较多的库或应用，变更项目会很多，不容易阅读。比较好的方式是在开头标记这个变更属于哪个模块，不属于任何模块的用 Other 标记。比如说你的应用有很多页面，则可以按页面来划分。如果是组件库，则可以按组件来分。如果是单个复杂组件，则可以按属性或功能来分。

## 2.1.0 - 2021-09-17

- Card: 增加 size (small/large/medium) 属性
- List: 新组件
- Button: 修复 loading 样式
- Input: 增加 warning 图标
- Other: 修复 IE 11 兼容性

细分变更类型

实践中，分类越详细，开发者维护变更日志的工作量越大。不分类是完全可行的，只有当你有充足的时间和很高的追求的时候，再考虑。

有很多种方法可以给变更分类。

按特性（Feature）和修复（Fix）分类是最简单可行的，也更符合当下软件工程的模型，容易配合各种项目管理工具。最重要的是，通常没有什么争议。

## 2.1.0 - 2021-09-17

### 特性

- Card: 增加 size (small/large/medium) 属性
- List: 新组件
- Input: 增加 warning 图标

### 修复

- Button: 修复 loading 样式
- Other: 修复 IE 11 兼容性

如果你听说过 Keep a Changelog ，它提供的分类方法要复杂得多。

## 1.0.0 - 2022-02-02

### 新增

- List: 新组件
- Input: 增加 warning 图标

### 更改

- Card: large size 的 padding 从 12px 调整为 16px

### 移除

- Card: align 属性，用 headerAlign 和 footerAlign 替代

### 废弃

- Input: focus 属性，建议用 Ref 

### 修复

- Button: 修复 loading 样式
- Other: 修复 IE 11 兼容性

对大部分项目来说，这样做意义不大，会消耗开发者更多的精力。因此建议变更不做细分，或者按照上面特性+修复的简单分类方法。

为什么不用 Git 历史

大多数项目的 Git 历史 commit message 含义不清，很难去阅读。

为什么不用项目管理系统

JIRA 和 AONE 之类的项目管理系统，或者 NPM 这样的软件包平台，确实能够在一定程度上记录软件发布历史。但实际项目中，会出现不得不从一个平台迁移到另一个平台的情况。这些发布记录有时候并不能随代码迁移到新平台。另外，软件分发给客户或者下游之后，他们并不一定能访问我们内部系统的发布历史。

2022年 3月 19日 | 评论

React 页面加载速度优化（非SSR）

React 应用页面首次加载通常比后端渲染静态页面慢，这对用户体验有着极大的负面影响，尤其是移动端。服务器端渲染（SSR）是非常有效的手段，但实现成本过高，不止要调整技术架构，也会增加服务器负载。那么在不使用 SSR 的前提下，如何优化 React 应用的首屏加载速度呢？

加载过程分析

使用 Firefox 开发者工具网络面板对页面加载过程中的网络流量进行监控，是最常用的分析方法。

注意右侧的进度瀑布图有两根线条，一根红色，一根蓝色：

蓝色是 DOMContentLoaded 事件触发的时间点
红色是 load 事件触发的时间点

但是对于 React 应用而言，以上两个事件并不标志着页面内容已加载完成。React 应用通常会需要请求一些 JSON 接口（比如商品信息），然后再加载 UI 组件（比如商品列表）。实际加载时间，我们可以通过 performance.now() 接口在组件实际挂载（componentDidMount 或 useEffect）时获取：

import React, { useEffect, useState } from 'react';

function App() {
  const [products, setProducts] = useState([]);
  useEffect(() => {
    fetch('api/products').then(res => res.json()).then(setProducts);
  }, []);
  if (products?.length > 0) {
    return <ProductList products={products} />
  } else {
    return <div>Loading...</div>;
  }
}

function ProductList({ products }) {
  useEffect(() => {
    console.log('ProductList loaded in ' + performance.now()/1000 + 's');
  }, []);
  return products.map(({name}) => <div>{name}</div>);
}

本地的测试分析不能反映实际用户的加载速度。建议将加载时长结果上报到服务器，进行统计分析，制作按日/小时的趋势图，以及按加载秒数的分布图。统计结果将有助于判断后续的优化工作的效用有多大。

数据加载优化

首屏展示依赖的数据，后端直接注入到 HTML 中，从而减少网络请求数量。

<script>
  window.user = {{ JSON.stringify(user) }};
  window.productInfo = {{ JSON.stringify(productInfo) }};
  window.translations = {{ JSON.stringify(translations) }};
</script>
<script src="path/to/js"></script>

要小心控制注入 HTML 中的数据数量，过大的 HTML 可能会导致页面加载失败的概率增加。首屏不展示的数据，或者不重要的数据要排除：Select 的数据源，弹窗中用到的数据，通知数据等。翻译数据最好按首屏需要做一次切分，且只透出当前用户语言。

从实践经验来看，这一项措施，对加载速度提升最为明显。

图标加载优化

icon font 是图标加载方式的主流，但加载字体文件会多发出一个请求。且字体请求通常是在 CSS 中触发，会阻塞页面加载。另外，字体文件很难根据首屏内容进行切分，不够灵活。某些大型应用，图标高达上百个，加载数 MB 的图标字体会让体验变得很差。

更好的方案是用 SVG Sprite 直接嵌入 HTML 中，或用 Inline SVG 直接嵌入 JS 中，减少一次网络请求，同时只加载首屏需要的图标。

打包尺寸优化

首先，建议所有使用 Webpack 4 的项目迁移到基于 Webpack 5 或者 Rollup 的构建工具，以使用 ES6 Module 的特性进行 Tree Shaking，去掉未被使用的部分，缩减产物尺寸。

对于 lodash 这种非 esm 包，建议用 lodash-es 替代或者采用分量引用：

// Bad
import _ from 'lodash';

// Good
import get from 'lodash/get';

最后，使用 Webpack Bundle Analyzer 插件分析产物尺寸，识别对产物体积影响较大的包。

存在多版本的包，考虑升级依赖版本进行优化。
尺寸过大的包，考虑轻量级替代品，比如 moment -> date-fns/day.js

代码分割

注意：不支持 IE，Edge < 16，Firefox < 60，Chrome < 61 和 Safari < 11

常见的构建工具都支持以下语法进行代码分割：

import React from 'react';
import Header from './Header';
const Description = React.lazy(() => import('./Description'));
const Comments = React.lazy(() => import('./Comments'));
const FeedbackDialog = React.lazy(() => import('./FeedbackDialog'));
const Footer = React.lazy(() => import('./Footer'));

function ProductDetailPage() {
  return <div>
    <Header/>
    <Description/>
    <Comments/>
    <FeedbackDialog/>
    <Footer/>
  </div>
}

对于首屏需要展示的组件，Header，我们用传统的引用方式打包，在页面加载时直接加载其 JS 和 CSS。而对于不会首屏展示的组件，用 ES6 模块动态加载。这样做之后，首屏加载的 CSS 和 JS 尺寸会缩小，从而加快首屏展示。

参考 React 官方文档

但实际项目中，构成项目产物的大部分来自第三方包，比如 React，Moment 和 Ant Design 这样的库，也就是 vendor chunk。如果你的业务代码产物 app chunk 在 gzip 压缩之后不超过 200KB，做代码分割的意义就不大了。

总结

在实际工作中，由于技术架构限制或是资源限制无法使用 SSR，我们还是有很多手段可以去快速优化 React 应用加载速度。

本文没有涉及 HTTP2，缓存策略，CDN 等优化传输速度的方法，因为这些是 DevOps 考虑的范畴，在大的 IT 公司中，都已经做得比较到位了，前端开发者不需要亲历亲为。

2022年 2月 27日 | 评论

前端构建工具测评

2022-04-02 更新：增加测评 JS Compiler 的测试数据

2022-03-21 更新：增加测评 Bundler 和 JS Minifier 的测试数据

前端构建工具已经形成了一个或多个复杂的生态系统。从最基础的 webpack, rollup 和 babel, esbuild, swc 等工具库，衍生出各种各样的插件，封装组合成 crate-react-app, vite, parcel, snowpack 这样通用解决方案，进而发展出 Next.js, ICE.js, UMI.js 这种特异化的行业解决方案。

这个生态中的每个部分，都有其替代品。比如 swc 可以替代 babel, rollup 可以替代 webpack。swc 确实比 babel 快得多，但是插件生态不如 babel 全面，两者互有胜负。项目的实际需求，决定了构建工具的选型。

随着前端工程越来越大，构建性能和热加载性能逐渐下降，大型项目不得不面临两个选择：

对仓库/应用进行拆分，采用微前端等复杂技术整合多个子应用。这样固然能够减少每次发布构建的时间，但是会增加开发人力开销。由于影响了项目架构，严重依赖人工，无法大批量复用到多个项目。
提升构建工具的性能，比如用 esbuild 这种原生程序替代 babel 这种 Node 程序，用 Vite 这种 Bundleless 工具替代 webpack-dev-server。相比迁移项目架构，改造构建工具的成本更低，完全可以通过迁移脚本自动化。

这篇文章会介绍和评测当前各种流行的构建工具，从底层库到完整解决方案，帮助大家选择和定制最适合自己的方案。

Bundler

Bundler 是能够通过 import/export 将很多 JavaScript 文件，打包成一个/几个文件的工具。在前端开发中，也经常会 Bundle 其他文件类型，比如 CSS/LESS/SCSS，以及图片和字体。这些部分通常是以 Bundler 插件的形式提供。因此 Bundler 通常是一个平台，可以通过插件来扩展特性。

Webpack 是最流行的 Bundler。Rollup，Parcel 则是后起之秀。以编译器见长的 esbuild 和 swc 也提供了 Bundle 能力，但是插件生态不足。

特性比较

spack 还处在实验阶段，功能缺失非常多，因此不建议在任何实际项目中使用。

esbuild 稍好一些，如果你不需要 CSS Modules，不用代码分割，不需要支持 IE，也不需要输出 UMD，那么 esbuild 是可以满足你的需求的。对于个人项目来说，这完全是可行的。对于企业项目，esbuild 作为 bundler 显然还不够全面，但它作为编译器和 Rollup 配合使用还是很好用的。

parcel，rollup 和 webpack 是功能最为全面的，能够应对绝大多数前端项目需求。webpack 的插件生态最丰富，兼容性也最好。rollup 和 parcel 则更加轻量化。Parcel 的 UMD 打包格式缺失，不适合用于组件库或微前端构建，但是对普通应用还是够用的。

	webpack	rollup	parcel	esbuild	spack
CSS Modules	✔️	✔️	✔️	✔️	❌
LESS	✔️	✔️	✔️	✔️	❌
Sass	✔️	✔️	✔️	✔️	❌
代码分割	✔️	✔️	✔️	❌	❌
CJS 输出格式	✔️	✔️	✔️	✔️	✔️
ESM 输出格式	✔️	✔️	✔️	✔️	✔️
UMD 输出格式	✔️	✔️	❌	❌	❌

性能比较

测试打包 antd + lodash + react + react-dom + three.js 的速度。为了控制变量，统一采用 esbuild 作为 minifier（spack 不支持除外）。

详细测试数据见 https://github.com/guoyunhe/benchmark-bundlers

	webpack	rollup	parcel	esbuild	spack
ThinkPad T480	5.347s	14.548s	6.069s	0.249s	1.082s
MacBook 16, 2019	4.229s	12.790s	5.225s	0.227s	1.012s

esbuild 是用 Go 语言编写，spack（swcpack）是用 Rust 语言编写。两者都编译成二进制文件运行，速度比其他 JS 编写的 Bundler 快几十倍。从 20s 到 0.2s 已经是一个质的飞跃了。

相比之下，传统的 JS Bundler 就慢得多了。令人意外的是，被很多人认为过时了的 webpack 居然比 parcel 和 rollup 更快。尤其是 rollup 的性能，令人意外地差。我们分析是因为 lodash 和 react 都是 CJS 模块，rollup 需要将其转化成 ESM 才能使用，因此比 webpack 慢了一倍多。

综合评价

目前 webpack 仍然是最全面的 Bundler 选择，支持特性最丰富，生态最为庞大。而且它的性能并不差，在应用打包场景要优于 rollup 和 parcel。

而放眼未来，esbuild 的潜力最大。它的性能无与伦比，且具有成熟的插件接口。它的代码分割能力已经在测试中，前途一片光明。甚至 Vite 也希望在 esbuild 成熟之后，移除 rollup 而直接用 esbuild 打包。

JS Minifier

Production 构建需要对 JS 文件和 CSS 文件进行 Minify 处理，让生成的文件更小，加载更快。JS 的 Minifier 包括 terser，esbuild，swc。衡量它们优劣的主要指标是速度和压缩率。

以下测试用 webpack + terser/esbuild/swc 打包和压缩 antd + lodash + react + react-dom+three.js。详情见 https://github.com/guoyunhe/benchmark-js-minifiers

	no-minify	terser	esbuild	swc
产物尺寸	4.7MB	1.8MB	1.9MB	1.9MB
运行时间 ThinkPad T480	4.677s	17.046s	5.615s	8.997s
运行时间 MacBook 16, 2019	3.556s	13.834s	4.052s	6.892s

esbuild 和 swc 在速度上大幅度领先 terser。对于这类高计算量任务，Node.js 的性能比原生程序差得多。同为原生程序，esbuild 比 swc 的性能更好，说明它的设计更优秀。而从压缩率上来看，terser 略好于 esbuild 和 swc 但差距不大。因此综合来看，我认为 esbuild 是最佳的 minifier。

JS/TS Compiler

我们在开发中喜欢使用最新的 ES 语法，但在发布时需要兼容旧的浏览器。JSX 和 Vue 文件还包含了特殊语法，即使最新的浏览器也无法识别和运行。因此越来越多的前端项目需要用 JS Compiler 或者叫 Transpiler 来转换源码。这也是一项非常耗时的任务。目前最广泛使用的编译器是 babel，它功能全面，但性能堪忧。而 esbuild 和 swc 则是以速度见长的面向未来的编译器。TypeScript 有自己的编译器 tsc，支持 TypeScript 的类型系统检查，但是它的效率极差。因此 Babel, esbuild 和 swc 都提供了自己对 TypeScript 转译的支持。

特性比较

从特性上来看，babel 仍然是最全面的。esbuild 和 swc 则注重对最新 ES 标准的支持，因此少了对非标准的 JS 修饰器语法（但是支持 TS 修饰器语法）和 Flow 语言的支持。esbuild 不兼容 ES5 和 IE 浏览器，但某些项目仍然有这方面的需求，开发者需要平衡利弊。

	babel	esbuild	swc
ES Next	✅	✅	✅
ES5, IE11	✅	❌	✅
JS 修饰器语法	✅	❌	❌
Flow 语言	✅	❌	❌
TypeScript 语言	✅	✅	✅
TS 修饰器语法	✅	✅	✅
JSX	✅	✅	✅

性能比较

以下测试用 Webpack + babel-loader/swc-loader/esbuild-loader 转译 antd + three.js 源码到 ES5 语法，不进行 minify。详见

	babel	esbuild	swc
运行时间 ThinkPad T480	10.133s	0.464s	0.549s
运行时间 MacBook 16, 2019

综合评价

如果不需要支持 IE11，那么 esbuild 是最好的选择，它的性能非常好。

如果需要支持 IE11，那么推荐 swc，性能接近 esbuild 且浏览器兼容性更好。

只有当 esbuild 和 swc 都无法支持你的项目需求时（比如用到了 JS 修饰器语法），再考虑 babel。babel 虽然功能最为全面，但性能比 esbuild 和 swc 慢几十倍，已经无法支持大型项目了。

Dev Servers

Webpack Dev Server

Webpack Dev Server 的出现，极大提升了 React 应用开发的效率：修改代码时，组件会自动被替换，无需手动刷新，也不会重新加载页面。然而早期的 Webpack 和 Webpack Dev Server 每次修改文件都会重新编译打包，给人越来越慢，又无能为力的痛苦感受。Webpack 5 和 Webpack Dev Server 4 已经在性能方面有了极大的改善。中小型项目的瓶颈大多不是 Webpack 本身造成，而是上面介绍过的 Compiler 和 Minifier。如果结合 swc 和 esbuild，Webpack Dev Server 仍然很能打。

但是在大型应用场景，Webpack Dev Server 还是有不足的。想象一下，你有一个包含几万行代码的 SPA 应用，且没有做代码分割。Webpack Dev Server 会将所有代码编译打包之后才能启动。这样一来，启动速度就会变得很慢。但实际上，我们每次只开发项目中很小的一部分，余下的页面/弹窗等组件并不需要提前编译加载。

但是这也并不是我们一定要抛弃 Webpack Dev Server 理由。大型应用场景，也极少硬着头皮上 SPA，而是用微前端框架将应用做进一步的切分。开发时 Webpack Dev Server 只需要运行子应用即可。

但是如果我们就是要做巨石 SPA 应用呢？在本地开发场景下，可以利用浏览器原生的 ES Module 能力动态地按需加载模块，而不需要编译打包所有内容。这样是不是就可以解决我们上面遇到的那个问题了呢？理论上行得通，但实际效果不尽如人意。

Snowpack

Snowpack 就是这样一个设计。理论上动态加载本地 JS 文件几乎没有延迟。但是这些模块并不都能直接在浏览器中运行。比如有很多 NPM 依赖是 CJS 而非 ESM 模块，我们写的代码有 JSX 和 TypeScript，更不要说还有 Sass，LESS，CSS Modules 这些要处理。因此动态加载每个文件时，都有一定的等待时间，而且无法并行处理。结果是在冷启动过程奇慢。在中小型项目开发中，不及 Webpack Dev Server 有效率。大型项目。而且，它并不能构建部署生产环境，仍然需要使用 Webpack 或 Rollup 来补足，无疑增加了项目维护成本。

因此在实际项目中，很难看到 Snowpack 的身影。Snowpack 本身的开发也陷入了很长时间的停滞不前。不过，Snowpack 的思路被 Vite 和 Parcel 2 所继承并改进，取得了成功。

Vite

Vite 给出了更好的答案：将依赖模块预先用 esbuild 进行 Bundle 以快速加载，项目模块采用 Unbundle 模式动态编译加载。

但是，Vite 对不同前端框架的支持程度是不同的，实际运行效率也差别很大。它的 Vue 插件用 esbuild 编译，速度极快。而它的 React 插件用的是 Babel 编译，速度一般。

另外我们发现，Vite 的缓存校验机制存在比较大的问题。更新 node_modules 中的依赖之后，Vite 缓存并没有更新。在开发过程中只能禁用缓存，这导致开发效率进一步降低。

Parcel 2

Parcel 2 和 Vite 的思路类似，但是有两个重要改进：

缓存范围更广，效率极高，热启动在 1s 内
采用了 swc 而非 babel 编译，构建和刷新速度更快

这两个优势使得 Parcel 2 在几乎各个性能指标上都领先于其他竞争对手。

性能比较

TODO

2022年 1月 24日 | 评论

TypeScript 枚举 Enum

JavaScript 本身是没有枚举的，Enum 是 TypeScript 带来的特性。

虽然早在 TypeScript 2.4 就已经提供了 Enum 但是并没有被广泛使用。TypeScript 一开始就有 Union Type，且语法更简单。因此 Enum 在 TypeScript 并不是必需的，出现较晚，且语法更加复杂，阻碍了它的流行。

但是，在大型项目中，Enum 有很多不可替代的优势，结合编辑器和IDE的功能，让类型的使用和维护更加轻松。

和 Union Type 比较

在 Enum 诞生之前，我们经常使用 Union Type 来表示枚举类型：

type Role = 'superadmin' | 'admin' | 'editor' | 'contributor';

const myRole: Role = 'editor';

如果改写成 Enum 的话：

enum Role {
  SuperAdmin = 'superadmin',
  Admin = 'admin',
  Editor = 'editor',
  Contributor = 'contributor',
}

const myRole = Role.Editor;

乍一看是不是代码繁琐了很多？那为什么我们还需要用 Enum 呢？Enum 和 Union Type 相比有两个优点：

可以对每个枚举成员添加注释
可以快速且精准地修改值和重命名

项目越大，类型也就会越多，相应的术语也就会越多。对每个枚举值成员添加注释，能够帮助新加入的开发者快速熟悉项目。尤其是国内的项目，中文的项目文档和英文代码之间的联系，注释必不可少。

/** 用户角色 */
enum Role {
  /** 超级管理员，可以增删管理员，配置和删除项目 */
  SuperAdmin = 'superadmin',
  /** 管理员，可以管理除了管理员外的成员角色 */
  Admin = 'admin',
  /** 编辑，可以直接编辑内容 */
  Editor = 'editor',
  /** 贡献者，可以参与讨论和提交补丁 */
  Contributor = 'contributor',
}

const myRole = Role.Editor;

当我们需要修改枚举值时，比如将 superadmin 改为 owner，Enum 就会非常简单。只需要将枚举值更改，而不需要去更改其他引用的地方。然而对于 Union Type，我们要小心翼翼地查找和替换每个出现的地方。加入我们想把 SuperAdmin 替换成 Owner，也只需要用 IDE 和编辑器提供的重命名/重构功能，快速而精确地重命名。这种维护的便利，也是 Enum 最大的魅力。

2021年 10月 28日 | 评论

单元测试：从 Jest 到 Karma+Mocha+Chai

我所参与过的 Web 项目大部分都使用 React 框架。Jest 是我们曾经最主要使用的单元测试 (Unit Test) 框架。Jest 配置足够简单，功能也足够丰富。但是随着前端开发逐渐进入深水区，Jest 的短板开始逐渐显现。我在经过探索和尝试后，迁移到了 Karma+Mocha+Chai 的解决方案。在此分享这两种技术方案的区别和取舍，希望对遇到同样问题的同学有所帮助。

继续阅读 →

2021年 3月 19日 | 评论