lodash 全量引入 216 KB 摇树失败先查 sideEffects 配置

打包分析打开一看,vendor 里 lodash 占了 216KB,业务代码实际只用了 debounCe 和 cloneDeep 两个方法。第一反应是改成按名引入,改完重新打包,体积一点没变。

查原因。lodash 的主入口是 CommonJS 的完整包,package.json 里没有 sideEffects 声明,打包器不敢做摇树,怕删掉带副作用的模块,只能整包留住。

换成 lodash-es,体积掉到 24KB,看着成了。上线后发现包又涨回 190KB,因为一个老组件写的是 import "lodash/throttle",两套实现同时进了包,一份 ESM 一份 CJS。

处理是把引用统一到方法级路径,禁止再从包名整包引入,lint 加一条规则拦住 lodash 前缀,构建时体积超阈值直接失败。

import debounce from "lodash-es/debounce";
import cloneDeep from "lodash-es/cloneDeep";
// 禁止整包引入 import _ from "lodash"

方法级引入也有代价,每个方法都是一个独立模块,请求数从 1 个变成 7 个。打包时把 lodash-es 的模块并进 vendor 一个 chunk,这个问题就没了,HTTP/2 下也不太在意。

类库之外还有一处白拿。项目里引了整份 element-plus,只用到表格和分页,按需引入配置一加,又省 380KB。这类问题比 lodash 更常见,因为 UI 库的入口文件会把所有组件注册一遍。

复测首屏 JS 从 1.1MB 降到 520KB,解析时间少 400ms,LCP 从 3.1 秒到 2.4 秒。构建里加了一条体积报告,任一 chunk 超过 200KB 就在 CI 里标红。

您可以还会对下面的文章感兴趣: