tree shaking 无法处理命名空间导入（import * as ns from 'module'），因其创建运行时对象且属性访问路径不可静态推断，导致整个模块被保守保留；应改用具名导入、默认导入或拆分模块粒度，并通过构建产物注释、可视化工具和体积对比验证效果。
Tree Shaking 无法处理命名空间导入（import * as ns from 'module'），因为它会阻止静态分析判断具体哪些导出被实际使用，导致整个模块被保守保留。
为什么命名空间导入会失效
命名空间导入本质是创建一个运行时对象，所有导出都作为该对象的属性存在。打包工具无法在构建阶段确定你后续是否通过 ns.xxx 访问了某个成员——尤其是当访问路径含变量、条件分支或动态计算时：
-
import * as utils from './utils.js'; console.log(utils[methodName]);—— 属性名由变量决定，完全不可静态推断 -
import * as api from './api.js'; if (env === 'prod') api.login();—— 调用逻辑在条件内，工具无法确认是否执行 - 即使只写了
utils.format，只要用了import *，工具仍需保留utils对象及其全部属性定义
替换成可摇动的导入方式
核心原则：用具名导入或默认导入，让依赖关系在语法层面明确可见。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- ✅ 改为具名导入：
import { format, parse } from './utils.js';—— Tree Shaking 可精确追踪每个符号的引用链 - ✅ 改为默认导入（若模块支持）：
import utils from './utils.js';—— 前提是该模块导出单个主对象且无副作用 - ✅ 拆分模块粒度：
import format from './utils/format.js';—— 直接按文件引入，天然隔离，零干扰
第三方库场景下的特别处理
遇到只提供命名空间导出的库（如某些旧版工具包），不能直接改源码，需绕过：
- 优先查找 ESM 替代品：例如用
date-fns替代moment，它天然支持import { format } from 'date-fns' - 使用插件重写导入：Vite 中可用
vite-plugin-imp，Webpack 中配合babel-plugin-import将import * as xx自动转为按需具名导入 - 手动封装一层：新建
./libs/utils-safe.js，内部用命名空间导入，但只重新导出真正需要的函数，再从该文件具名引入
如何验证是否修复成功
不靠猜测，用工具看结果：
- 构建后搜索产物中是否存在
/* unused harmony export xxx */注释 —— 有说明标记阶段完成，Terser 后续会删掉 - 用
rollup-plugin-visualizer或source-map-explorer查看依赖图，确认原模块是否已从最终 bundle 中消失 - 对比修改前后 bundle 大小变化，尤其关注引入该模块的 chunk 是否明显缩小
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
