babel 不直接提供 @babel/polyfill，已弃用；应使用 core-js（v3/v4）配合 @babel/preset-env 实现精准垫片。babel 负责语法转换和按需注入 api 垫片（依赖 core-js），core-js 提供实际垫片逻辑，分 stable 和 proposals 两部分。usebuiltins 有 false（仅语法）、entry（全量引入）、usage（按需注入）三种模式，需匹配 corejs 版本（如 corejs: 3），路径须正确（如 core-js/stable），并注意 regenerator-runtime 的显式引入或通过 @babel/plugin-transform-runtime 解决。
现在 Babel 本身不直接提供 @babel/polyfill，它已被弃用；主流做法是用 core-js（v3 或 v4）配合 @babel/preset-env 来实现 API 层面的垫片填补。关键不是“要不要加”，而是“怎么加才精准、不污染、不冗余”。
明确核心分工
Babel 负责两件事：
– 语法转换（如 async/await、箭头函数、解构赋值）
– API 垫片注入（如 Promise.allSettled、Array.prototype.flatMap），但这部分必须靠 core-js 实现，Babel 只负责按需引入或统一入口引入。
core-js 是真正提供垫片逻辑的库，它用 ES5 写法模拟所有新标准 API，包括稳定特性（core-js/stable）和提案阶段特性（core-js/proposals）。
选对 useBuiltIns 模式
@babel/preset-env 的 useBuiltIns 配置决定垫片如何注入，有三个取值：
-
‘false’（默认）：只做语法转换，不处理任何 API 垫片。即使你写了
Promise.any()，Babel 也不会自动加 polyfill，运行时可能报错。 -
‘entry’：要求你在项目入口文件（如
index.js或main.ts）顶部手动写：import 'core-js/stable';<br>import 'regenerator-runtime/runtime';
Babel 会根据.browserslistrc中的目标环境，把所有缺失的 API 垫片一次性引入。适合全量兼容、入口可控的应用场景。 -
‘usage’：无需手动 import，Babel 在编译时扫描源码，只在用到某个新 API 的地方，动态插入对应模块，例如：
['a', 'b'].flat(); // → 编译后自动加 require('core-js/modules/es.array.flat');更轻量，但要注意：不能用于动态字符串调用（如eval('Promise.allSettled()')），也无法覆盖全局构造器原型上被重写的场景。
版本与路径要匹配
使用 core-js@3+ 时，babel.config.js 必须显式声明 corejs: 3（或具体版本号），否则会警告或行为异常：
module.exports = {
presets: [
['@babel/preset-env', {
useBuiltIns: 'usage',
corejs: 3 // 必填！不可省略
}]
]
};
同时注意导入路径写法：
-
import 'core-js/stable'→ 填补所有稳定标准 API（推荐大多数项目） -
import 'core-js/stable/array/from'→ 只填一个方法，适合极简包体积控制 -
import 'core-js/proposals/string-replace-all'→ 用提案中但尚未标准化的功能
不要混用 core-js@2 的路径（如 core-js/es6/promise），v3 已重构模块结构，路径不兼容。
避免 regeneratorRuntime 报错
只要用了 async/await 或生成器函数，就必须确保 regenerator-runtime 可用：
- 若用
useBuiltIns: 'entry'，已包含import 'regenerator-runtime/runtime'，没问题 - 若用
useBuiltIns: 'usage'，Babel 不会自动引入regenerator-runtime，需单独安装并显式导入：npm install regenerator-runtime --save<br>// 然后在入口文件第一行加上：<br>import 'regenerator-runtime/runtime';
- 更优解是搭配
@babel/plugin-transform-runtime（尤其适合库开发），它把regeneratorRuntime和辅助函数抽成独立依赖，不污染全局作用域。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
