tree shaking 对第三方库无效，主因是其采用 commonjs 格式或未声明副作用；解决方式包括：优先替换为 lodash-es、date-fns 等 esm 原生库；次选插件转换（如 vite-plugin-commonjs）；再辅以手动路径导入和 sideeffects 字段修正。
Tree Shaking 对第三方库无效，根本原因在于库本身不满足静态分析前提——最常见的是发布格式为 CommonJS（require/module.exports），或虽用 ESM 但未正确声明副作用。这不是你代码写得不对，而是依赖项“先天不适配”。解决方向很明确：绕过、替换、或强制适配。
优先换用 ESM 原生支持的替代库
这是最干净、长期维护成本最低的方式。很多主流工具库已提供 ESM 友好版本：
-
lodash → lodash-es：官方 ES 模块版，导出颗粒度细，支持按需导入
import { debounce } from 'lodash-es' -
moment → date-fns 或 dayjs：前者全 ESM + 零副作用，后者体积小且默认支持 Tree Shaking（需搭配插件如
dayjs-plugin-import） - axios → ky 或 fetch-based 封装：轻量、ESM 原生，无运行时副作用
用插件转换 CommonJS 库为可摇动形式
当无法更换库（如企业内部 SDK、历史遗留包），可借助构建工具链做“现场翻译”：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- Vite 用户：添加
vite-plugin-commonjs，它会在构建时将 CommonJS 模块转为 ESM，并尝试保留导出结构 - Webpack 用户：配合
babel-plugin-transform-commonjs或启用resolve.fullySpecified: true，再结合optimization.usedExports: true - 注意：转换不能 100% 还原 ESM 语义，尤其含动态
require或运行时条件分支的库，仍可能保留整包
手动分包 + 显式路径导入（兜底方案）
适用于 Ant Design、Element Plus 等组件库——它们虽提供 ESM 入口，但主入口仍会触发副作用或默认导出大对象。此时应跳过主包，直连子模块：
- 不写：
import { Button } from 'ant-design-vue'（主入口含样式注入、全局配置等副作用） - 改写：
import Button from 'ant-design-vue/lib/button'或import 'ant-design-vue/lib/button/style/css' - 配套使用
babel-plugin-import（React）或unplugin-vue-components（Vue），自动重写 import 路径并按需加载样式
检查并修正 package.json 的 sideEffects 字段
即使你用了 ESM 版本，若库的 package.json 没声明 "sideEffects": false，打包器仍会保守保留全部文件。你可以：
- 查看该库源码的
package.json，确认是否有该字段；没有就说明作者未承诺无副作用 - 在你自己项目的
package.json中，对这个第三方库单独设置别名 + 重写sideEffects（Webpack 支持resolve.alias+resolve.roots配合自定义解析逻辑） - 更稳妥的做法：fork 该库，补上
"sideEffects": false并发布私有版本，或提 PR 推动上游修复
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
