第一步：先弄明白哪些是Tree Shaking

Tree Shaking当前这个名字听起来像在摇树一样，但实际情况是是个优化技术手段。简洁就是当你引用一个库的时候， 走捷径。 只把自己用到的一部分拿过来没用到的一部分就"摇掉"了。这样打包出来的文件就较小更多了。

为哪些要用Tree Shaking？

• 降较低文件较大较小 - 只保留需要的代码
• 加迅速网页加载速度 - 较小文件传输更迅速
• 节省带较宽 - 更少下载无用代码

第二步：准备良好ES模块格式

要实现Tree Shaking， 先来看必须要采用ES6模块系统，不能用老陈旧的CommonJS。这是因为ES模块是静态解析友良好的，而CommonJS不是。

ES模块vs CommonJS

特性	ES模块	CommonJS
导入方式	import {xxx} from 'module'	const xxx = require
静态解析友良好度	✔️ 较高度友良好	❌ 不友良好
Tree Shaking支持度	✔️ 支持很良好	❌ 不支持或很差劲儿
所以必须要得用ES模块！不能偷懒！

第三步：组织良好你的代码结构

来日方长。 这里有个关键点：各个功能要单独放在一个文件里！不能把全部代码都丢进一个较大文件里。

正确做法示例：按功能拆分文件夹和单独导出!

javascript // utils/add.js export function add { return a + b; }，平心而论...

// utils/subtract.js export function subtract { return a - b; }，等着瞧。

// index.js export { add } from './utils/add'; export { subtract } from './utils/subtract';，性价比超高。

错误做法警告！

function subtract { // 没有导出！ 没准儿… return a - b; }

如果像上面这样写，即使subtract函数没被采用也无法被"摇掉"！ 站在你的角度想... 一定要记住各个功能单独导出哦~

第四步：配置package.json

package.json里必须要设置sideEffects字段！否则Tree Shaking有可能不会生效。

json { "name": "my-library", "version": "1.0.0", "main": "dist/index.cjs.js", // commonjs版本入口 "module": "dist/index.esm.js", // ESM版本入口 "types": "dist/index.d.ts", // TypeScript类型声明 "files": , // ⚠️ 下面这行很十分沉关键！ "sideEffects": false // 告诉打包工具没有副作用能够可靠移除未引用代码 }，一针见血。

特殊情况处理：

如果你有真实正需要落实顶层副作用的文件，能够明确列出来： json "sideEffects":

第五步：选择打包工具并配置

Rollup推荐采用！

我倾向于... Rollup是为库设计的构建工具，天然对Tree Shaking支持很良好。

小丑竟是我自己。 javascript // rollup.config.js 配置示例 import pkg from './package.json';

export default { input: 'src/index.js', output: , exter 操作一波。 nal { return /^react|lodash/.test; // 外部依赖不要打包进去! }, };

Webpack也能够但麻烦些...

Webpack需要额外配置mode为production才能激活tree shaking： javascript module.exports = { mode: 'production', // 必须要设置成production! optimization: { usedExports: true, // 开启标记未采用导出 minimize: true // 压缩代码时会移除未采用代码 } };，PPT你。

第六步：验证Tree Shaking有没有生效

检查打包最终还是结果是：

bash

webpack --display-modules --stats-json | grep my-library/utils/subtract.js，何必呢？

哎，对！ cat dist/index.esm.js | grep subtract # 应当返回空最终还是结果是如果未被引用!

测试示例项目：

创建测试项目安装你开发中的库： bash mkdir test-project && cd test-project && 极度舒适。 npm init -y && npm install ../path/to/your/library --save-dev

npm i webpack webpack-cli -D && npx webpack ./test-file-that-only-imports-add-functi 别纠结... on --mode=production --output-pathinfo=true | grep your-library/add # 应当只有add相关代码存在!

常见问题与陷阱：

⚠️ 动态import会阻止tree shaking！

javascript // 错误写法! 动态路径让构建工具无法解析: const modul 别怕... ePath = someCondition ? './a' : './b'; import.n

// 正确写法! 必须要采用静态路径: if{ i 嗐... mport.n }else{ import.n }

⚠️ 默认导出也会作用于tree shaking效果！

尽量避免默认导出，而是采用命名导出。

错误例子： javascript // bad-practice-default-export.js 中... function utilA{...} function utilB{...}，什么鬼？

export default {utilA, 拯救一下。 utilB}; // 整个对象作为默认值!

摸鱼。 // 调用方: import allUtils from 'bad-practice-default-export'; // 换句话说...整个对象都要被引入了! allUtils.utilA; ... 正确写法： javascript // good-named-exports-utils/aaa-bbb.ccc-ddd.eee-fgg.hhh-iijj.kklmmm.nnnooo.ppprrr.sssstttt.uuuvvvvwww.xxxyyyyyzzzz..qqqwwwweee.rrrttttyyyyuuu.aaaabbbcccddeeefffgghhiijjjkklmmnnooppqqqrrrssstttuuuvvvwwwwxxxxyyyyyyzzzz....js 中...

function utilA{...} function utilB{...}

export {utilA as aaaUtilA}; export {utilB as zzzUtilB};，靠谱。

// 调方: import {aaaUtilA} from 'good-named-exports-utils/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/...'; ...

⚠️ 生产周边环境必须要压缩才能真实正移除死代码！

归根结底。 仅标记usedExports不够!还需要启动minimize压缩才会真实正删除这一些死代码!

最佳实践：

1. 坚持采用ESM语法!绝不回头去玩CommonJS那个地方的破玩意儿。
2. 各个功能独立文件并单独导出!不要全部堆在一起。
3. 严格控制sideEffects字段!没有副作用?直接false!!
4. 选择合适工具链!Rollup最平稳,Vite崭新但也不错。
5. 生产周边环境必须要压缩!否则标记再完美也只是标记而已。
6. 频繁验证打包最终还是结果是!确保没必不可更少地暴露任意私有依赖。

良好了各位同志们就是这样啦~按照这套方法搞下来应当就能实现对比理想化程度非常之较高非常之彻底彻底彻底根本绝对确定必定一定能够确定的是百分百万中无一错漏地完美支持tree shaking喽!

不过记住啊同学们——虽然说这技术手段挺神奇但是别滥杀无辜哈~有些依赖项确实必不可更少呢比如jQuery和Bootstrap这种老古董~，探探路。

---