javaScript 模块化演进为从无到有、手动管理到标准化的过程,es6模块(ESM)与 Commonjs是两大主流方案,核心差异在于加载时机(编译时静态 vs 运行时动态)、导出机制(活绑定 vs 值拷贝)、语法设计(default/named 导出 vs 单一 module.exports)及运行环境适配。

javascript模块化的发展,是从无到有、从手动管理到标准化的过程。早期脚本直接写在页面里,依赖 全局变量 和命名约定;后来为解决冲突和复用问题,出现了多种模块规范,最终 ES6 模块(ecmascript Module, ESM)成为官方标准,而 CommonJS 则是 node.js 长期使用的主流方案。两者核心差异不在“谁更好”,而在设计目标、执行时机和运行环境不同。
模块加载时机:编译时 vs 运行时
ES6 模块是静态的,在代码解析阶段(编译时)就确定依赖关系。import 必须写在顶层 作用域 ,不能放在if 或函数里,也不能动态拼接路径。这使得 工具 可以做静态分析、tree-shaking、循环 依赖检测等优化。
- 合法:
import {foo} from './utils.js'; - 非法:
if (condition) {import { bar} from './bar.js'; }(语法错误)
CommonJS 是动态的,在 require() 执行时才去查找、加载、执行模块。它支持条件引入、循环引用的延迟求值,也允许在任意位置调用require。
- 合法:
if (env === 'dev') require('./debug.js'); - 合法:
const mod = require('./' + name + '.js');(路径可计算)
导出与导入机制:绑定 vs 值拷贝
ES6 模块导出的是 ** 活的绑定(live binding)**:导出的变量与原始变量保持连接。如果模块内部修改了导出的值,其他导入该值的地方会同步看到更新。
立即学习“Java 免费学习笔记(深入)”;
CommonJS 导出的是 ** 值的浅拷贝(snapshot)**:module.exports在 require 返回时被冻结,后续对原变量的修改不影响已导入的 对象。
例如:
- ES6 中:
export let count = 0;→ 其他模块import {count}后,原模块count++,导入处count也会变 - CommonJS 中:
module.exports = {count: 0};→ 导入后修改原模块的count,导入对象里的count不变(除非改的是对象属性,且导入的是同一引用)
默认导出与命名导出:语法与语义差异
ES6 区分 default 和named导出,语义清晰:
-
export default function() {}→ 导入时可自定义名称:import myFunc from './mod.js'; -
export const a = 1; export function b() {}→ 必须按名导入:import {a, b} from './mod.js';
CommonJS 只有单一导出对象module.exports,所有导出都通过这个对象挂载:
-
module.exports = function() {};→ 相当于 ES6 的export default -
module.exports.a = 1; module.exports.b = () => {};→ 类似 ES6 的export {a, b},但需import * as mod from或解构const {a} = require(……)
注意:CommonJS 没有语法级的“默认导出”概念,export default在 ES6 中是语言特性,不是约定。
运行环境与互操作性:node.js如何桥接两者
Node.js 从 v12 起支持 ESM,但默认仍用 CommonJS(.js 文件)。启用 ESM 需满足以下任一条件:
两种模块不能直接混用:import不能直接引入 CommonJS 模块(反之亦然),但 Node.js 提供了兼容层:
- ESM 中
import pkg from 'commonjs-pkg'可导入 CommonJS 包(自动读取module.exports) - CommonJS 中
await import('./esm.mjs')可动态导入 ESM 模块(返回promise)
不过静态 import 语句无法导入 CommonJS 的具名导出(如 import {x} from 'cjs' 会报错),只能导入默认导出。