动态导入不参与tree shaking静态分析,但其加载的模块内部仍受tree shaking约束;两者协同可实现更细粒度按需加载与体积优化。

动态导入(import())和 Tree Shaking 是两种不同层级的优化机制,它们目标一致——减小体积,但作用方式、触发时机和影响范围完全不同。简单说:动态导入不参与 Tree Shaking 的静态分析,但它能绕过 Tree Shaking 的限制,实现更细粒度的按需加载;而 Tree Shaking 仍会在每个被动态加载的模块内部生效。
动态导入本身不被 Tree Shaking 分析
Tree Shaking 依赖的是 ES 模块的静态导入结构(顶层 import 语句),而 import() 是一个返回 Promise 的函数调用,属于运行时行为。构建工具无法在编译期确定它最终会加载哪个模块、加载多少内容,因此:
- 不会把
import('./utils.js')中的./utils.js纳入主 bundle 的依赖图进行导出标记 - 不会因为你在某处写了
import('./feature-a.js')就去分析feature-a.js是否被其他静态 import 引用 - 换句话说:
import()是“隔离的”,它的模块是独立打包、独立分析的
Tree Shaking 仍在动态加载的模块内起作用
虽然入口不可知,但一旦某个模块被 import() 加载,它自身的结构仍受 Tree Shaking 规则约束。只要满足前提条件,该模块内部未使用的导出依然会被剔除:
- 模块必须使用
export而非module.exports - 该模块所在包的
package.json中sideEffects声明合理 - 你从该模块中只
import { funcA },而非import * as mod或import mod
例如:你写 const { debounce } = await import('lodash-es');,Webpack 仍会把 lodash-es 打包成一个独立 chunk,并只包含 debounce 及其依赖,其余函数(如 throttle、memoize)不会进入这个 chunk。
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
常见组合用法与效果差异
同一功能,不同写法对打包结果影响显著:
-
静态全量引入:
import _ from 'lodash-es'; _.debounce(...);→ 整个lodash-es进入主包,Tree Shaking 失效(因 namespace 导入) -
静态具名引入:
import { debounce } from 'lodash-es';→ 主包仅含debounce,Tree Shaking 生效 -
动态具名引入:
const { debounce } = await import('lodash-es');→debounce单独成 chunk,主包完全不包含 lodash 代码,且该 chunk 内部仍被 Tree Shaking
后两者体积都小,但动态方式进一步延迟了加载时机,适合非首屏、条件触发或大体积逻辑(如图表、编辑器、PDF 渲染)。
注意事项:别让动态导入“白忙一场”
以下情况会让动态导入失去体积优势,甚至抵消 Tree Shaking 效果:
- 在
import()内部又做了全量导入,比如import('./chart').then(m => m.default.render()),而./chart里写了import * as echarts from 'echarts'→ 整个 echarts 进入该 chunk - 动态导入路径是变量或拼接字符串(如
import(`./features/${name}.js`)),导致 Webpack 生成所有可能匹配的模块,形成大量冗余 chunk - 没配置
splitChunks或chunkLoading,导致动态 chunk 未被压缩或未启用预加载










