JavaScript模块化主流规范有CommonJS和ES6 Module两种广泛落地,前者用于Node.js默认环境,后者获现代浏览器及新版Node原生支持;AMD/CMD已基本淘汰。

JavaScript模块化主要有四种主流规范:CommonJS、AMD、CMD 和 ES6 Module(ESM)。目前实际项目中真正广泛落地的是 CommonJS(Node.js 默认)和 ES6 Module(现代浏览器与新版 Node.js 原生支持),AMD/CMD 已基本被历史淘汰,仅在极老项目中可见。
语法写法不同
这是最直观的区别:
- CommonJS 用
module.exports或exports.xxx导出,用require('./x')导入 - ES6 Module 用
export(命名导出)、export default(默认导出),用import导入,且必须写明扩展名(如.js)或使用完整路径 - CommonJS 的
require是函数调用,可写在任意位置;ES6 的import是声明语句,只能出现在顶层,不能放在 if 或 try 里
加载时机与执行逻辑不同
本质差异在于“动态”还是“静态”:
- CommonJS 是运行时同步加载:代码执行到
require才去读文件、执行模块、返回结果;支持条件加载、循环 require - ES6 Module 是编译时静态加载:所有
import在代码解析阶段就被分析确定,依赖关系固定;不支持运行时条件导入(除非用import()动态导入函数) - 这种静态性让打包工具(如 Webpack、Vite)能做 tree-shaking——自动剔除未使用的导出代码
值传递方式不同
影响变量更新是否同步:
立即学习“Java免费学习笔记(深入)”;
- CommonJS 导出的是值的拷贝:比如导出一个数字或字符串,后续模块内修改它,不会反映到已导入的地方
- ES6 Module 导出的是值的动态只读引用:导出一个对象或函数,其内部属性变化会同步体现;但不能重新赋值整个导出绑定(如
export let a = 1; a = 2允许,但a = {}不行) - 典型例子:一个计数器模块,ES6 中多个地方 import 同一个
let count = 0,都能看到彼此的count++变化;CommonJS 则各自拿到初始值的副本
环境与配置要求不同
实际使用需注意兼容性细节:
- Node.js 中,默认是 CommonJS;启用 ESM 需满足三者之一:
.mjs后缀、package.json中设"type": "module"、或命令行加--experimental-modules(旧版) - 浏览器原生支持
,但不支持 bare import(如import {foo} from 'lodash'),必须用相对/绝对 URL - 两者不能混用:不能在 .cjs 文件里写
import,也不能在 .mjs 里用require(除非通过createRequire曲线救国)
基本上就这些。选型上,新项目优先用 ES6 Module;纯 Node.js 后端脚本仍常见 CommonJS;跨环境(如同时跑在前端和 Node)建议统一用 ESM 并配好构建工具。










