ES模块是JavaScript原生模块系统,需在支持环境显式声明类型;export仅限顶层、路径须字符串字面量;import默认与命名导出混用需注意语法;模块绑定为实时引用。

ES 模块(import/export)不是“可选语法糖”,而是 JavaScript 原生模块系统,必须在支持模块的环境(如现代浏览器、Node.js ≥12 且启用 "type": "module")中使用,否则会直接报错。
模块文件必须显式声明为模块类型
浏览器中, 标签必须加上 type="module" 属性,否则 import/export 会被当作语法错误:
Node.js 中,要么将文件后缀改为 .mjs,要么在 package.json 中设置:
{ "type": "module" }
不满足任一条件,运行时会抛出 ReferenceError: require is not defined 或 SyntaxError: Unexpected token 'export'。
立即学习“Java免费学习笔记(深入)”;
export 的三种写法和关键限制
export 只能出现在模块顶层(不能在 if、函数或块级作用域内),且不能用在表达式上下文里。常见写法包括:
-
export const foo = 42;—— 命名导出,可多次 -
export function bar() {}—— 函数/类也可直接导出 -
export { foo, bar };—— 重命名导出:export { foo as baz }; -
export default function() {}—— 每个模块最多一个默认导出,接收时不需大括号
注意:export default 后不能跟 var/let/const 声明(如 export default const x = 1 是非法的),只能跟表达式或函数/类声明。
import 的路径必须是字符串字面量
import 的模块说明符(即引号里的路径)必须是静态字符串,不支持变量拼接或动态计算:
import { foo } from './utils.js'; // ✅ 正确
const path = './utils.js';
import { foo } from path; // ❌ SyntaxError
动态导入要用 import() 函数(返回 Promise):
const mod = await import('./utils.js'); // ✅ 动态导入,路径可为变量
但 import() 不能用于顶层(只能在函数或 async 上下文中),也不能替代静态 import 做常规依赖管理。
默认导出和命名导出混用时的导入写法容易混淆
假设 math.js 写了:
export const PI = 3.14;
export default function add(a, b) { return a + b; }
那么正确导入方式是:
import add, { PI } from './math.js'; // ✅ 默认导出 + 命名导出
不能写成:
import { add, PI } from './math.js'; // ❌ add 不是命名导出,是默认导出
也不能写成:
import add from './math.js'; // ✅ 可以,但 PI 就访问不到
更隐蔽的坑:如果只用了命名导出,却误加了 default,比如 import { default as add } from './math.js',会报 undefined —— 因为 default 是关键字,不是导出名。
模块解析路径是相对当前文件的,不是执行位置;循环依赖时,导出对象是“实时绑定”的(修改导出值,导入方看到的也会变),这点和 CommonJS 的拷贝值不同——实际调试时容易忽略这个差异。











