tree-shaking 无法剔除原型方法，因其具有隐式副作用且破坏esm静态可分析性；应改用纯函数导出，或在sideeffects中显式声明原型扩展文件。
Tree-shaking 无法剔除原型方法，根本原因在于：这类写法天然带有副作用，且破坏了 ESM 的静态可分析性。打包工具（如 Webpack、Rollup、Vite）在构建期无法安全断定“修改原型”是否被后续代码依赖——哪怕你只在工具模块里写了 Array.prototype.mapAsync = ...，整块代码也会被保留，因为它可能影响全局行为。
原型扩展本身就是隐式副作用
向内置对象（Array、Object、Date 等）或自定义类原型添加方法，属于典型的“有副作用”操作。即使它出现在模块顶层，也违背了 pure module 原则：
- 打包工具看到
Array.prototype.myMethod = function() {...}，会认为该模块可能改变运行时环境，不敢删除整个模块 - 即便你只 import 了其他导出，只要模块含原型修改，
"sideEffects": false就不生效 - 这种写法无法被静态判定为“未使用”——因为它的作用不是被调用，而是被“执行”
避免原型扩展，改用纯函数或工具对象
这是最直接有效的解法。把原本挂在原型上的逻辑，转为命名导出的独立函数：
- ❌ 错误示范：
// utils.js<br>Array.prototype.chunk = function(size) { /*...*/ };<br>export const chunk = Array.prototype.chunk; - ✅ 正确做法：
// utils.js<br>export function chunk(arr, size) { return arr.reduce(/*...*/); }<br>// 使用时：<br>import { chunk } from './utils';<br>const result = chunk(myArray, 3);
这样既保持调用简洁，又确保 tree-shaking 可以精准识别未使用的函数并剔除。
若必须扩展原型，请显式声明并隔离副作用
极少数场景（如 polyfill 或特定 SDK）确实需要原型扩展。此时需主动告知打包工具哪些文件含副作用：
- 在
package.json中明确列出："sideEffects": ["./polyfills/array.js", "./polyfills/object.js"] - 将所有原型扩展集中到单独文件（如
polyfills/目录），不与其他逻辑混写 - 确保这些文件本身不导出任何功能，只做副作用执行；其他模块通过
import './polyfills/array.js'显式引入（这种导入会被保留，但不会污染其他模块的 shaking）
检查第三方库是否偷偷修改原型
有些老旧或设计不良的库会在初始化时扩展原型（例如某些 moment.js 插件、lodash 的旧版 mixin 方式）。这类库即使你只用了其中一两个函数，也可能导致整包无法被 shake：
- 用
npm ls <pkg></pkg>查看实际安装版本，优先选用已迁移到 ESM + 无副作用的现代替代品（如date-fns替代moment） - 搜索库源码或文档中是否有
prototype、defineProperty、__proto__等关键词 - 在构建后用
source-map-explorer检查产物中是否意外包含大量原型补丁代码
