JavaScript模块是运行时真实隔离的作用域单元,需type="module"声明,遵循严格模式、defer执行、路径带扩展名等规则,导出导入基于实时绑定与单例机制。

JavaScript 模块就是能独立封装变量、函数、类,并控制哪些内容对外暴露的脚本文件——不是语法糖,是运行时真实隔离的作用域单元。
模块必须用 type="module" 才生效
浏览器中直接写 默认是非模块环境,export 会报 Uncaught SyntaxError: Unexpected token 'export'。必须显式声明:
注意:type="module" 脚本默认是 defer 行为(按顺序下载、DOM 解析完才执行),且自动启用严格模式。
- 不能用
file://协议直接双击打开(会触发 CORS 错误),得用本地服务器(如npx serve或 VS Code Live Server) - 模块路径必须带扩展名(
import { foo } from './utils.js'),不支持自动补.js - 相对路径以当前模块文件为基准,不是 HTML 页面位置
export 的三种写法和导出对象本质
所有 export 最终都挂载到模块的 exports 对象上,只是语法糖不同:
立即学习“Java免费学习笔记(深入)”;
-
export const a = 1→ 命名导出,可批量重命名导入:import { a as A } from './x.js' -
export default function() {}→ 默认导出,一个模块只能有一个,导入时名字任意:import anyName from './x.js' -
export { a, b as B }→ 重新导出已有声明,不创建新绑定(改原值,导入处也同步变)
注意:export default 后面不能接 function 声明(会报错),要写成 export default function foo() {} 或 export default function() {}(匿名)或 const foo = () => {} + export default foo。
import 不是“加载一次”,而是绑定+单例
多次 import 同一路径,不会重复执行模块代码,也不会重复初始化顶层变量:
/* counter.js */
let count = 0
export function inc() { return ++count }
export const now = Date.now()/* a.js */ import { inc } from './counter.js'; inc() // → 1
/* b.js */ import { inc, now } from './counter.js'; console.log(inc(), now) // → 2, 同一个时间戳- 导入的是实时绑定(live binding),不是值拷贝:如果导出的是
let变量,修改它,所有导入处都能看到新值 - 循环依赖能工作,但未执行完的模块返回空对象(
{}),后续赋值才可见 - 动态
import()返回 Promise,可用于按需加载,且路径可以是表达式:import(`./pages/${page}.js`)
Node.js 里模块路径和 CommonJS 混用容易崩
Node.js 14+ 默认仍用 CommonJS(require() / module.exports),启用了 ESM 需满足至少一项:.mjs 后缀、package.json 中 "type": "module"、或命令行加 --input-type=module。
- ESM 中不能用
require(),CommonJS 中不能用import(除非用dynamicImport包) -
__dirname和__filename在 ESM 中不存在,要用import.meta.url+fileURLToPath() - 第三方包若只有 CommonJS 版本(无
"exports"字段或"type": "module"),在 ESM 项目中import它会失败,需配node --experimental-loader ts-node/esm类工具转译
真正麻烦的不是语法,是模块解析规则和运行时行为差异——比如浏览器里 import 路径必须带 ./ 或 ../,而 Node.js ESM 允许省略(但仅限内置模块和 node_modules 中的包)。











