在分析Webpack打包产物时，细心的开发者会发现整个bundle的开头通常是(function(){...})()这样的结构，而末尾还有一个对应的调用括号。这个结构就是立即执行函数表达式（IIFE）。控制这个行为的正是output.iife配置项。它看起来简单，但很多人对它的作用范围存在误解，比如误以为它会包裹每一个模块，或者关闭它就可以减小体积。要正确使用它，需要先弄清楚它到底包裹的是什么，以及在什么情况下关闭会出问题。
output.iife 到底包裹的是什么
首先要澄清一个常见误区：output.iife并不是把每个模块都单独包成一个立即执行函数。Webpack在打包时，会把所有模块合并进一个（或多个）chunk文件中，每个模块在bundle内部是以函数形式存在，并被注册到模块缓存里的。output.iife控制的是整个bundle最外层是否再套一层立即执行函数。
开启时（默认值，对应iife: true），产物大致长这样：
(() => { // webpackBootstrap
var __webpack_modules__ = { /* 模块定义 */ };
// 模块加载与执行逻辑
})();关闭时，webpackBootstrap里的那些变量会直接暴露在文件顶层作用域中。如果你把这样的bundle通过<script>标签直接引入到浏览器，__webpack_modules__等变量就会变成全局变量，如果页面里恰好有同名的全局变量，就会被覆盖，产生非常隐蔽的bug。所以在浏览器环境直接使用未压缩的script场景下，这个包裹层起到了作用域隔离的关键作用。
不同模块格式下的表现差异
output.iife并不是在所有情况下都生效。它的行为和output.library.type、目标环境以及产物格式密切相关。
当输出为ES Module（即library.type: 'module'）时，ES模块本身就有独立的作用域，文件顶层声明的变量不会污染全局，因此Webpack会自动忽略iife的设置，产物不会被包裹。这也是为什么有人发现改了这个配置却毫无变化的原因。
当输出为CommonJS或AMD格式时，模块本身运行在宿主模块系统的作用域内，同样不需要额外的IIFE包裹。而UMD格式比较特殊，它会根据环境判断导出方式，外层本身已有函数结构，iife的干预程度也有限。真正受它影响最明显的，是output.library未配置、直接输出为传统script的场景。
可以做个简单实验验证：写两个入口模块，分别打包后对比产物首行，观察webpackBootstrap是否被包裹。示例配置如下：
const path = require('path');
module.exports = {
mode: 'production',
entry: './src/index.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'bundle.js',
iife: true // 改为 false 对比产物差异
}
};打包后打开bundle.js就能直观看到区别。开启时首行是(() => {，关闭时则是直接以var __webpack_modules__ = ...开头。这个实验能帮助建立对配置作用范围的直观认知。
关闭 output.iife 能优化体积吗
不少文章建议关闭iife来减小体积，这个说法需要辩证看待。从字符数上说，包裹层本身只多了几个字符，体积收益几乎可以忽略。但关闭它会带来一个连带影响：顶层作用域不再是函数作用域，代码压缩工具（如Terser）对顶层变量的混淆策略会变得保守，某些情况下变量名无法被缩短，反而可能导致产物变大。
什么时候适合关闭？典型场景是产物会被进一步处理的情况。比如最终输出会被合并进一个更大的IIFE容器，或者构建目标是某些嵌入式环境、特定的小程序运行时，这些环境对代码结构有特殊要求，多一层包裹反而会干扰宿主的处理逻辑。另外，如果配合output.scriptType或模块联邦等机制，也需要关注包裹层的影响。
对于绝大多数常规的Web项目，保持默认的iife: true是最稳妥的选择。它带来的作用域隔离价值远大于几个字符的体积开销。如果确实担心全局污染或需要精细控制作用域，还可以结合output.globalObject来指定全局对象的挂载目标，例如在浏览器环境显式写成：
module.exports = {
output: {
globalObject: 'this',
iife: true
}
};总结一下：output.iife包裹的是整个bundle的最外层，而不是每个模块；ES Module输出下它会被自动忽略；默认开启是最安全的选择，只有产物会被二次处理或目标环境有特殊约束时才考虑关闭。理解了它的作用边界，遇到全局变量冲突或产物结构异常的问题时，就能快速定位到这个配置上。
Webpackoutput.iife立即执行函数修改时间：2026-09-07 11:48:39