@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-env
npm 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）除非你显式使用了该方法。

Java Maven Secondary Analysis

分析ZIP压缩包或GitLab仓库中的Java Maven项目，确定二次开发范围、类数量、模块分布及生产相关指标。

下载

立即学习“Java免费学习笔记（深入）”；

• 若你用了 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