组件库打包出来 512KB,引了 lodash 和 dayjs,实际只用了 debounCe 和 format 两个函数。
package.json 里加了 sideEffects 为 false,想靠 tree-shaking 把没用到的模块摇掉。重新构建,产物 512KB,一个字节没少。
用 webpack-bundle-analyzer 打开,lodash 整个包还在,71KB gzip。翻 babel.config.js,presets 里 @babel/preset-env 没写 modules,默认把 ESM 转成了 CommonJS。require 是运行时调用,webpack 静态分析不出哪些导出被用到,摇树直接失效。
改成 modules 为 false,输出保留 import 和 export,交给 webpack 自己处理。构建完体积掉到 368KB,lodash 里只剩 debounce 相关的三个文件。
// babel.config.js
module.exports = {
presets: [
['@babel/preset-env', { modules: false }],
],
};
接着样式没了。按钮组件引的 button.css 被当成无副作用的模块删掉,页面上全是裸元素。sideEffects 设成 false 等于告诉 webpack 所有文件都可以丢,包括那些只为执行副作用而 import 的样式。
改成数组,只放行样式和补丁文件,再构建体积 372KB,样式回来了,4KB 差价就是那点 polyfill。
"sideEffects": ["*.css", "*.less", "./src/polyfill.js"]
还有一个坑在依赖上。lodash 自己的 package.json 没声明 sideEffects,webpack 默认按有副作用处理,只能摇到文件级,函数级摇不动。换成 lodash-es 之后才摇到函数级,体积又掉 46KB。
确认方式:analyzer 里 lodash 节点下的模块数从 600 多降到 3;gzip 总体积从 512KB 到 326KB;再跑一遍组件快照测试,样式和交互都正常。
现在 CI 里加了一条,产物 gzip 超过 400KB 就 fail,同时导出 analyzer 的 json 存档,谁引入的大包一眼能看到。
