如何使用Webpack 5与Babel 7构建适配IE11的JavaScript代码包
基于Webpack 5 + Babel 7 适配IE11的实操步骤
核心适配逻辑
IE11的兼容问题分两类:
- 不识别ES6及以上的语法(比如箭头函数、类、
const/let、解构赋值) - 缺少现代JS内置API(比如Promise、
Array.prototype.includes、fetch)
分工逻辑为:Babel负责把ES6+语法转成ES5规范,同时通过core-js给缺失的API打补丁;Webpack负责把所有代码(包括自身生成的运行时、chunk加载逻辑)全量输出为ES5格式,避免自带代码不兼容。
第一步:安装必需依赖
按职责区分安装不同类型的依赖,执行以下命令:
- 开发依赖(仅打包环节使用,不打进最终产物):
npm i -D webpack webpack-cli @babel/core babel-loader @babel/preset-env - 生产依赖(需要打进产物的兼容补丁):
npm i core-js@3 regenerator-runtime
说明:core-js是官方推荐的API补丁库,regenerator-runtime用于兼容async/await语法的转译
第二步:统一配置兼容目标(browserslist)
新建.browserslistrc文件,写入以下内容:
ie 11 > 0.2% not dead
说明:这个配置会被Babel、Webpack自动读取,不用在两个工具里重复写兼容目标,避免配置不一致。
第三步:配置Babel 7
新建babel.config.js,写入核心配置:
module.exports = { presets: [ [ '@babel/preset-env', { // 按需引入API补丁,避免全量打包导致体积过大 useBuiltIns: 'usage', // 对应安装的core-js版本,必须填写3 corejs: 3 } ] ] }
关键注意点:
- 不要使用已经废弃的
@babel/polyfill,目前统一采用core-js@3的兼容方案useBuiltIns: 'usage'会自动检测代码里用到的IE11缺失API,仅打对应补丁,包体积最小
第四步:配置Webpack 5(最高发踩坑环节)
新建webpack.config.js,核心配置如下:
module.exports = { // 核心:指定输出既要适配web环境,又要全量转成ES5语法 target: ['web', 'es5'], module: { rules: [ { // 用babel-loader处理所有js文件 test: /\.js$/, // 默认排除node_modules,避免打包速度过慢 // 如果某个第三方依赖本身包含ES6代码导致IE11报错,把这个依赖的路径从排除项里去掉即可 exclude: /node_modules/, use: 'babel-loader' } ] }, // 如果不想用target: es5,也可以手动细粒度控制Webpack输出的兼容特性,效果等价 /* output: { environment: { arrowFunction: false, // 不输出箭头函数,转成普通function const: false, // 不输出const,转成var destructuring: false, // 不输出解构,转成ES5写法 forOf: false, // 不输出for...of循环 dynamicImport: false // 把动态import转成IE11支持的JSONP加载逻辑 } } */ // 入口和输出路径按项目实际情况修改即可 entry: './src/index.js', output: { filename: 'bundle.[contenthash].js', path: __dirname + '/dist' } }
踩坑提醒:很多人只配置了babel-loader,忘了修改Webpack的target或output.environment,结果打包出来的Webpack自带的chunk加载、运行时代码都是ES6语法,IE11直接报「语法错误」,这是最常见的适配失败原因。
第五步:最终验证
- 打包完成后,打开dist目录下的产物文件,全局搜索箭头函数
=>、const、let这类ES6语法,如果没有匹配项,说明语法转译完成 - 用IE11打开打包后的页面,确认控制台无报错,所有功能正常运行
常见问题排查
- 如果async/await在IE11里报错:在项目入口文件的最顶部,手动引入
import 'regenerator-runtime/runtime'即可 - 如果某个第三方组件在IE11里报错:打开对应组件的源码,确认是否使用了ES6语法,是的话把这个组件的路径从babel-loader的exclude排除项里移出去,让Babel也转译这个依赖
- 如果打包出来的包体积太大:检查browserslist的配置是不是太宽松,确保只保留需要兼容的目标环境,不要加多余的范围
可选包体积优化
如果项目是多页面/多chunk的,可以安装@babel/plugin-transform-runtime,避免Babel转译时生成的辅助函数(比如_classCallCheck这类)重复打包到每个chunk里:
- 先安装依赖:
npm i -D @babel/plugin-transform-runtime - 在
babel.config.js的presets同级添加plugins配置:
plugins: [ [ '@babel/plugin-transform-runtime', { regenerator: true } ] ]
注意:这个插件只处理辅助函数的复用,不会替代core-js的API补丁,core-js还是需要保留。
内容的提问来源于stack exchange,提问作者anthumchris
相关产品推荐
相关产品推荐

