webpack 配了 sideEffects 体积没降 Tree shaking 为什么没摇掉

// package.json
'sideEffects': false
# 引入方式
import { debounce } from 'lodash-es'

只引了一个工具函数，打包体积还是把整个库带进来，sideEffects 也按文档配过了。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。

追下去是这么回事：库本身是 CommonJS 或者带副作用标记，webpack 判断不出哪些导出没被用到，只能整包保留。

「Tree shaking 失效」排查到最后往往是很小的一处差异，前面那些复杂猜测可以先放一放。权限不要一口气开到最大，先加到够用再往上试，范围小才好收。

把复现步骤压到三条以内，交给同事也能跑出来，才算真的定位清楚。改动写完就同步给同事，下一个人踩同一个坑，成本还是你的。

验证用真实数据走一遍，测试数据太干净，边界情况根本碰不到。能分两步做的操作就别合成一步，中间看一眼返回值，出问题好判断。

处理上按这个顺序：确认引入的是 ES 模块版本；在 package.json 里标好 sideEffects；用体积分析看模块是否还在。

确认没问题再收工，产物体积下降，分析图里只剩实际用到的那一个模块。