babel 的作用是将 esm 语法转译为 cjs 等目标环境可执行的等效代码,仅处理 import/export 语法层面转换,不模拟模块加载逻辑;默认通过 @babel/plugin-transform-modules-commonjs 插件实现,配合 importinterop 选项控制默认导出互操作行为。

ES Modules(ESM)本身不能直接在旧版浏览器或部分 Node.js 版本中运行,Babel 的作用不是“支持 ESM”,而是把 ESM 语法转成目标环境能执行的等效代码,比如 CommonJS(CJS)。关键不在于能否写 import/export,而在于转译后是否保留语义、是否与运行时协同。
明确转译目标:ESM → CJS 是最常用路径
大多数项目用 Babel 配合 @babel/plugin-transform-modules-commonjs,把 import/export 转成 require/module.exports。它只处理语法层面,不模拟模块加载逻辑——那由 Webpack、Node 或浏览器自己负责。
- 静态分析仍有效:Babel 不改变 import/export 的位置限制(必须顶层),所以打包工具仍能做依赖图分析
- 默认导出需特殊标记:转译后会加
Object.defineProperty(exports, "__esModule", { value: true }),让后续工具知道这是 ESM 风格导出,避免import React from 'react'变成undefined - 命名导出直接映射:
export const a = 1→exports.a = 1;import { a } from './x'→const { a } = require('./x')
配置 importInterop 选项,决定如何处理默认导出
CommonJS 和 ESM 的默认导出机制不同。Babel 提供 importInterop 控制互操作方式,默认是 "babel",也支持 "node"(匹配 Node.js 的 ESM/CJS 互操作规则)或 "none"(完全不加适配)。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 选
"babel":适合搭配 Webpack 或 Rollup,生成带__esModule标记的 CJS,确保import X from 'x'正确取到x.default - 选
"node":适合纯 Node.js 环境(如用esm包或 Node 14+ 的--experimental-modules),更贴近官方行为 - 慎用
"none":除非你完全控制所有导入方,否则容易出现undefined导入
面向现代浏览器时,用 @babel/preset-modules 替代 preset-env
如果目标只是支持 <script type="module"></script> 的浏览器(Chrome 61+、Firefox 60+、Safari 10.1+、Edge 16+),没必要降级全部语法。@babel/preset-modules 只修复已知 bug,保留 async/await、箭头函数、解构等原生特性。
- 不设 targets,自动适配 module-supporting 浏览器,覆盖约 88% 用户
- 例如:Safari 10.3 类内异步箭头函数会被转,但普通 async 函数不动;Edge 16 解构参数默认值会被重写,其余语法原样保留
- 配合 HTML 的
module/nomodule策略,可分发两套 JS:现代版用 ESM + 最小转译,老版本用完整降级包
注意边界:Babel 不解决模块解析和加载
Babel 只管语法转换,不管路径怎么找、文件从哪来。比如:
-
import './util.js'中的.js后缀,在浏览器 ESM 中是强制的,但 Babel 不补也不删——得靠构建工具或服务器配置 -
import('path')动态导入会被转成Promise.resolve().then(() => require('path')),但 CommonJS 没有动态加载语义,实际运行仍需 Webpack 或类似支持 - 循环依赖、live binding 等 ESM 特性,Babel 无法 100% 模拟,CJS 是快照式导出,这点在跨模块状态共享时要特别留意
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










