Tree Shaking 不会剔除类内部未使用的方法或属性，仅作用于模块级未引用的导出；因类是原子导出项，导入即全量保留，无法静态分析内部调用，需改用具名函数导出等细粒度方式实现有效摇树。
Tree Shaking 本身**不会过滤类内部未使用的方法或属性**，它只作用于模块层级的未引用 导出（export）。类是一个整体值，只要这个类被导入并实例化、继承或静态访问，整个类定义（包括所有方法和属性）都会保留——无论其中哪些方法实际没被调用。
为什么类方法不能被 Tree Shaking 单独剔除
ES 模块规范中，export class MyClass 是一个原子导出项。打包器看到 import { MyClass } from './utils'，就认为整个类是“被使用”的；它无法深入分析类体内部哪些方法在运行时从未被调用（那属于动态行为，超出静态分析能力）。这和函数级具名导出有本质区别：
- ✅
export function foo() {}+import { foo } from './x'→ 只打包foo - ❌
export class A { method1() {}; method2() {} }+import { A } from './x'→ 整个A类（含method1和method2）全量保留
真正可行的替代方案
想让无用方法不进入最终包，需绕过“类整体导出”这一层，改用更细粒度、可静态分析的组织方式：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
-
拆分为独立的具名函数导出：把每个方法单独导出，而非包裹在类里
utils.jsexport const validateEmail = () => { /* ... */ };export const formatPhone = () => { /* ... */ };export const sendRequest = async () => { /* ... */ };
然后按需导入：import { validateEmail, sendRequest } from './utils'—— 这样未引入的formatPhone就能被摇掉 -
避免类作为导出主体，改用工厂函数或纯对象：如果必须保持面向对象风格，可导出一个创建实例的函数，而非类本身
export const createService = () => ({
validate: () => { ... },
send: () => { ... }});
调用方解构所需方法：const { validate, send } = createService()—— 此时若只用validate，send的定义仍可能被保留（因是对象属性），但至少避免了class语法带来的强耦合 - 用 TypeScript + 构建工具做进一步优化（有限）：某些现代工具链（如 esbuild + dce 插件、SWC）可在更高层级做死代码消除，但依赖具体配置且不保证 100% 安全，不能替代模块级 Tree Shaking
需要避开的陷阱
以下写法看似“按需”，实则会阻断 Tree Shaking 或导致整类保留：
立即学习“Java免费学习笔记（深入）”；
-
import * as utils from './utils'—— 命名空间导入，打包器无法判断哪些成员被读取 -
export default class A { ... }—— 默认导出类，无法按方法粒度 shake - 类中有顶层副作用（如
console.log('init')或修改全局变量）—— 即使没人 new 它，也可能因 sideEffects 机制被强制保留 - 通过字符串拼接调用方法：
instance[methodName + 'Handler']()—— 动态访问，静态分析失效
验证是否生效的关键动作
别依赖直觉，动手确认：
- 构建后打开
dist目录产物，搜索某个你确定没导入/调用的方法名，看是否出现在 JS 文件中 - Vite 项目执行
vite build --report，在生成的report.html中检查该方法所属模块是否被引用 - Webpack 项目启用
stats: "verbose"或用webpack-bundle-analyzer查看 chunk 组成
