在 javascript 项目中通过 tree shaking 移除未使用的 dayjs 模块,核心做法是确保使用 es module (esm) 语法进行导入,并配置构建工具(如 webpack、vite)的摇树优化功能。具体而言,应使用 import dayjs from 'dayjs' 引入核心库,并通过按需引入插件的方式加载所需功能,这样构建工具才能识别并剔除未引用的代码。若直接引入整个库或 commonjs 格式,tree shaking 将失效。

如何正确导入 dayjs 以支持 Tree Shaking
要实现 Tree Shaking,必须使用 ESM 语法的 import 语句,避免使用 require。正确的做法是直接导入 dayjs 主模块,而不是导入其内部的具体文件路径,除非你明确知道该路径是纯函数且无副作用。对于插件,同样采用按需导入的方式,只引入实际使用的插件模块。这样做可以让打包工具分析依赖图,标记未使用的导出为死代码并移除。

import dayjs from 'dayjs';
import localeData from 'dayjs/plugin/localeData';
import weekOfYear from 'dayjs/plugin/weekOfYear';
// 启用插件
dayjs.extend(localeData);
dayjs.extend(weekOfYear);
// 使用功能
const now = dayjs();
console.log(now.locale('zh-cn').format('YYYY-MM-DD'));
console.log(now.week());上述代码中,只有 localeData 和 weekOfYear 被导入并扩展,其他所有 dayjs 的功能(如相对时间、自定义解析等)都不会被包含在最终包中。如果项目中没有使用 weekOfYear,则删除对应的 import 行即可实现剔除。
立即学习“Java免费学习笔记(深入)”;
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。
Webpack 与 Vite 中的 Tree Shaking 配置差异
虽然现代构建工具默认开启 Tree Shaking,但配置细节有所不同。Webpack 需要在 mode 设置为 'production' 时生效,或者在 development 模式下手动启用 optimization.usedExports 和 optimization.sideEffects。Vite 基于 Rollup,默认对 ESM 模块进行彻底的 Tree Shaking,无需额外配置,只要确保 package.json 中的 sideEffects 字段正确声明即可。对于 dayjs,由于其部分插件可能带有副作用,需确认插件是否纯函数。大多数 dayjs 插件是纯函数扩展,因此可以安全地被摇树优化。

// webpack.config.js 示例
module.exports = {
mode: 'production', // 生产模式自动启用
optimization: {
usedExports: true, // 标记未使用的导出
sideEffects: true, // 根据 package.json 的 sideEffects 字段处理
},
};Vite 用户只需确保使用 ESM 导入,并在 package.json 中检查 dayjs 的 sideEffects 配置。dayjs 官方已正确配置了 sideEffects,指向其样式文件和全局副作用脚本,而纯 JS 模块不会被误判。因此,在 Vite 中直接使用 import dayjs from 'dayjs' 即可获得最佳效果,无需修改构建配置。
dayjs 插件导入对最终包体积的具体影响
当引入特定插件时,最终包体积会增加该插件的代码量。例如,引入 relativeTime 插件会增加约 1KB 的压缩后代码,而引入 customParseFormat 会增加更多。通过对比不同导入组合的打包结果,可以量化 Tree Shaking 的效果。如果未使用任何插件,仅核心 dayjs 库约为 2-3KB。每增加一个插件,体积线性增长。开发者应根据实际需求选择插件,避免全量引入导致包体积膨胀。

















