@babel/preset-env 通过 usebuiltins: 'usage' 可按需注入 core-js@3 的 polyfill,仅在源码实际使用 es api(如 promise、array.from)时自动导入对应模块,避免全局污染与全量加载。

在 JavaScript 项目中,@babel/preset-env 可以根据你指定的目标浏览器(targets)自动判断哪些 ES 特性需要转译、哪些 API 需要 Polyfill,并配合 core-js 按需注入 Polyfill,而不是全量引入。
启用 automatic polyfill 注入(推荐方式)
从 Babel 7.4.0 开始,@babel/preset-env 支持通过 useBuiltIns: 'usage' 自动按需引入 core-js 的 Polyfill —— 它会扫描你的源码,只在实际用到某个 API(如 Promise、Array.from、Object.assign)时,才引入对应的 polyfill 模块。
- 安装必要依赖:
npm install --save-dev @babel/preset-envnpm install --save core-js@3(必须是 v3,v2 已废弃) - 在
.babelrc或babel.config.js中配置:
{
"presets": [
["@babel/preset-env", {
"targets": { "chrome": "58", "ie": "11" },
"useBuiltIns": "usage",
"corejs": 3
}]
]
}
注意:不需要手动 import 'core-js/stable' 或 import 'regenerator-runtime/runtime',Babel 会自动在使用对应特性的文件顶部插入最小化 import。
确保入口文件不污染全局环境
如果你希望 Polyfill 仅作用于当前模块(避免污染全局),保持 useBuiltIns: 'usage' 即可。它默认只注入当前文件真正需要的 polyfill,且不会修改全局对象(如 Array.prototype.map)除非你显式使用了该方法。
- 若你用了
Array.from([]),Babel 会自动加import "core-js/stable/array/from"; - 若你用了
async/await,会自动加import "regenerator-runtime/runtime"; - 所有注入路径都基于
core-js@3的模块结构,精确到子模块
避免常见陷阱
几个容易出错的关键点:
-
不要同时写
import 'core-js/stable'—— 这会导致全量加载,抵消usage的按需效果 -
corejs: 3必须显式声明,否则 Babel 默认按 core-js@2 解析,引发错误或缺失 polyfill -
目标浏览器要写具体版本,例如
"chrome": "58"而不是"chrome": "last 2 versions"(后者可能模糊,影响判断精度) -
第三方库里的 API 使用不会被检测 ——
useBuiltIns: 'usage'只分析你自己的源码,所以依赖库若用了新 API,需靠useBuiltIns: 'entry'或单独处理
替代方案:useBuiltIns: 'entry'
适用于需要全局 Polyfill 的场景(比如兼容老旧第三方库):
- 在项目入口文件(如
index.js)顶部写:import 'core-js/stable';import 'regenerator-runtime/runtime'; - Babel 会把这两行替换为按
targets精简后的实际 polyfill 列表,比如只引入 Promise + Array.from + Symbol 等 - 配置中仍需设
"useBuiltIns": "entry", "corejs": 3
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











