Webpack的require.ensure如何确定加载依赖？无显式依赖为何加载大量chunk

安全阿岳

2026-9-27

require.ensure 额外加载大量chunk的原因说明

你观察到的require.ensure编译后自动加载大量未声明chunk的现象，核心是Webpack的依赖收集、chunk拆分规则导致的隐式依赖注入，常见来源如下：

SplitChunks 公共提取规则的自动依赖补全
Webpack 的optimization.splitChunks配置会自动把多个chunk共享的模块拆分为独立公共chunk。当你的my-chunk依赖的任意模块（包括Webpack注入的运行时代码、polyfill、公共工具函数等）属于某个公共chunk时，Webpack会将所有关联的公共chunk都加入require.ensure对应的加载列表，确保异步回调执行时所有依赖都已加载完成。
回调函数内的隐式依赖被静态扫描捕获
即使你清空了require.ensure回调的业务代码，只要编译阶段回调内部仍存在未被完全清除的require调用（例如注释残留、未触发tree shaking的条件分支内的依赖、转译工具插入的导入逻辑），Webpack的静态依赖扫描会将这些依赖全部归入my-chunk的依赖树，触发关联chunk的加载。
编译工具链注入的全局依赖
若项目配置了Babel自动导入插件、全局polyfill注入规则、自定义Webpack插件等，可能会给所有异步chunk统一注入公共依赖，若这些依赖被拆分为多个独立chunk，就会产生额外的加载请求。
编译缓存残留
Webpack 5默认开启的持久化缓存可能残留旧的依赖信息，若之前版本的my-chunk关联了大量依赖，缓存未清除时新的编译结果仍会保留旧的chunk加载逻辑，删除node_modules/.cache/webpack目录与构建产物目录后重新编译可排除该类问题。