JavaScript模块加载原理与ES6、CommonJS、AMD对比详解
时间:2026-02-20 08:00:45 114浏览 收藏
JavaScript模块系统历经CommonJS、AMD到ES6 Module的演进,三者本质互不兼容——CommonJS仅限Node同步运行,浏览器直接执行会报错;AMD依赖require.js实现异步加载,却非原生支持;而ES6 Module作为现代标准,在浏览器和Node中均原生可用,但需严格遵循静态解析、绑定导出等规则。混用模块不仅需复杂构建工具桥接,还易引发隐蔽bug,因此理解差异、合理迁移而非强行兼容,才是高效开发的关键。

JavaScript 模块加载器不是“一个东西”,而是不同规范在不同时期对「如何拆分代码、声明依赖、按需执行」给出的解决方案。CommonJS、AMD、ES6 Module(import/export)三者本质不兼容,不能混用,也不能靠“改个后缀”就自动转换。
CommonJS 只在 Node.js 里同步工作,浏览器直接跑会报 require is not defined
Node.js 的 require() 是同步读取文件、立即执行、返回模块导出对象。它依赖 Node 的文件系统和运行时封装,浏览器没有 require 全局函数,也没有同步读本地文件的能力。
- 典型错误:把
index.js用直接引入,里面写了const fs = require('fs')→ 浏览器报错require is not defined - 常见误解:以为 Babel 把
import编译成require就等于支持 CommonJS 浏览器运行 —— 实际上只是语法转换,仍需打包工具(如 Webpack)注入运行时来模拟require - Node.js v12+ 虽支持
.mjs和type: "module",但此时require()不可用,import才是默认行为,和传统 CommonJS 环境已隔离
AMD 是为浏览器异步加载设计的,但需要 define() 包裹且依赖 require.js 运行时
AMD(Asynchronous Module Definition)解决的是“页面不卡死”的问题:模块可以并行下载、按依赖顺序执行,不阻塞渲染。但它不是语言原生特性,必须靠库(如 require.js)提供 define() 和 require() 函数。
- 写法必须显式包裹:
define(['./a', './b'], function(a, b) { return { sum: a.val + b.val }; }); - 没引入
require.js就调用define→define is not defined - 即使用了
require.js,也无法直接import一个 ES6 模块文件,除非配置插件或转译;反过来,ES6 模块也不能require('./xxx')AMD 模块 - 现代构建链路(Vite/Webpack/Rollup)基本不生成 AMD 输出,仅遗留项目或特定 CDN 场景(如 Dojo 1.x)还会遇到
ES6 Module 是浏览器和 Node.js 都原生支持的静态模块系统,但加载时机和 this 行为与 CommonJS 不同
import 和 export 是语法级特性,解析阶段就确定依赖图,不能动态拼接路径(import(expr) 是特例,返回 Promise),且模块顶层 this 是 undefined(CommonJS 中是 exports 对象)。
- 浏览器中必须用
,否则import语法报错;且模块默认是strict mode - Node.js 中要加
"type": "module"到package.json,或用.mjs后缀,否则import会被当作语法错误(除非用--experimental-modules,但已废弃) export default导出的是值的绑定(live binding),不是拷贝 —— 如果模块内部改了let x = 1,其他模块import { x }看到的也会变;而 CommonJS 的module.exports = {...}是导出时的一次性快照import()动态导入返回 Promise,可用于条件加载或路由懒加载:if (needChart) { const { Chart } = await import('./chart.js'); new Chart(); }
混用模块系统的代价远高于收益,迁移时优先选构建工具而非手动桥接
试图让 import 直接加载 CommonJS 模块(或反之),往往需要配置 resolve.extensions、transform 插件、甚至重写 require 函数。这些方案脆弱、难调试、且掩盖了模块语义差异。
- Webpack 默认能处理
import和require混写,但这是靠内部包装器模拟,实际输出仍是统一格式(如 IIFE 或 ES Module);它不改变两种模块的执行逻辑差异 - Vite 默认只支持 ES Module,遇到
require会报错,必须用插件(如vite-plugin-commonjs)做运行时转换,但无法支持所有 CommonJS 动态特性(如基于环境判断的require(x + y)) - 真正该关注的不是“怎么让它们一起跑”,而是“哪些模块可以升级、哪些必须保留、是否值得为遗留模块单独建个兼容层”
以上就是本文的全部内容了,是否有顺利帮助你解决问题?若是能给你带来学习上的帮助,请大家多多支持golang学习网!更多关于文章的相关知识,也可关注golang学习网公众号。
相关阅读
更多>
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
187 收藏
-
114 收藏
-
383 收藏
-
299 收藏
-
219 收藏
-
448 收藏
-
346 收藏
-
423 收藏
-
328 收藏
-
106 收藏
-
212 收藏
-
240 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习