深拷贝工具需确保esm兼容、命名导出、无副作用、编译不降级，并对非esm库做动态导入隔离。具体包括：选用lodash-es等esm包并具名导入；package.json设sideeffects白名单；ts/babel配置禁用模块降级；非esm库通过动态导入隔离。
深拷贝依赖（如 lodash.cloneDeep、fast-deep-equal 或自研工具函数）本身体积不大，但若引入方式不当，极易破坏 Tree Shaking，导致整包或无关逻辑被保留。关键不在“深拷贝”本身，而在它如何被导入、导出和使用。
确保深拷贝模块使用 ES 模块语法并支持命名导出
很多深拷贝工具提供多个分发版本，必须选用 ESM 兼容、支持按需导入的版本：
-
优先选专用 ESM 包：例如用
lodash-es替代lodash，再写import { cloneDeep } from 'lodash-es'； -
避免默认导出对象：像
export default { cloneDeep, isEqual }这种写法会让打包器难以静态分析，改用具名导出export { cloneDeep, isEqual }； -
验证第三方库是否含
"module"字段：查看其node_modules/xxx/package.json，确认有"module": "dist/index.js"或类似字段，表明它提供原生 ESM 入口。
在项目中禁用副作用干扰，显式声明 sideEffects
即使深拷贝函数本身无副作用，若它所在文件或依赖链中存在顶层执行语句（如日志、polyfill 注入），整个模块就可能被保守保留：
- 在项目根目录
package.json中设置："sideEffects": false（表示所有 JS 文件无副作用）； - 若项目中有 CSS、字体或全局初始化脚本，改用白名单形式："sideEffects": ["*.css", "src/init.ts"]；
- 检查你封装的深拷贝工具文件（如
utils/clone.ts）是否在顶层写了console.log、localStorage.setItem等——这些都会让该模块无法被摇掉。
规避 Babel / TypeScript 编译对模块结构的破坏
TS 或 Babel 若把 import { cloneDeep } from 'lodash-es' 编译成 require()，Tree Shaking 就彻底失效：
-
TypeScript：在
tsconfig.json中设 "module": "ESNext" 和 "importsNotUsedAsValues": "error"； -
Babel：在
.babelrc或babel.config.js中，@babel/preset-env必须配置 "modules": false； - 构建后可检查
dist目录下的代码，确认仍为import/export，而非require/module.exports。
对非 ESM 深拷贝库做手动隔离与动态导入
若必须使用不支持 ESM 的深拷贝库（如老版本 clone 或某些私有工具），不能直接 import，应将其“副作用化”隔离：
- 新建一个单独文件
legacy-clone.ts，仅在此处import clone from 'clone'并导出封装函数； - 在项目
package.json的sideEffects字段中显式列出该文件路径，如 "src/utils/legacy-clone.ts"； - 业务中改用
const { cloneDeep } = await import('./utils/legacy-clone')—— 动态导入天然支持代码分割，且不会污染主包 Tree Shaking 流程。
