JavaScript模块加载原理与ES6、CommonJS、AMD对比详解
2026-02-20 08:00:45
0浏览
收藏
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学习网公众号。
VisualStudio配置Go工具链教程
- 上一篇
- VisualStudio配置Go工具链教程
- 下一篇
- 番茄小说书籍存放位置及管理技巧
查看更多
最新文章
-
- 文章 · 前端 | 13小时前 |
- CSS @scope 怎么限制组件样式泄漏:嵌套范围、优先级与降级检查
- 366浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · css · 表单 · CSS 响应式布局 表单 field-sizing
- CSS field-sizing: content 怎么让输入框随内容变宽:最小宽度、最大宽度和降级验收
- 442浏览 收藏
-
- 文章 · 前端 | 1天前 | javascript · 前端工程 · 浏览器API · Web Locks API navigator.locks 前端多标签页
- Web Locks API 怎么防止多标签页重复刷新:ifAvailable、超时与失联恢复
- 386浏览 收藏
-
- 文章 · 前端 | 1天前 |
- SPA 导航失败怎么保留旧内容:Navigation API 的 navigateerror 与重试回退
- 308浏览 收藏
-
- 文章 · 前端 | 1天前 |
- 前端 SPA 导航怎么统一接管:Navigation API 的拦截、失败恢复与回退
- 291浏览 收藏
-
- 文章 · 前端 | 1天前 | css · 前端开发 · 无障碍设计 · CSS 无障碍 color-mix design token
- CSS 主题按钮怎么用 color-mix() 派生 hover 与浅底:对比度和 fallback 实战
- 173浏览 收藏
-
- 文章 · 前端 | 1天前 | css · 前端开发 · 无障碍设计 · CSS 无障碍 color-mix design token
- CSS color-mix() 做主题色派生:从 design token 到对比度验收
- 406浏览 收藏
-
- 文章 · 前端 | 3天前 |
- 中文标题总是断得难看?CSS text-wrap balance 的宽度约束与降级验收
- 330浏览 收藏
-
- 文章 · 前端 | 3天前 |
- CSS text-wrap: balance 怎么让中文标题更稳:max-width、降级与可访问性
- 353浏览 收藏
-
- 文章 · 前端 | 3天前 |
- CSS Anchor Positioning 怎么做浮层定位:position-try 回退、可访问性和旧浏览器降级
- 349浏览 收藏
-
- 文章 · 前端 | 1星期前 |
- 前端 WebSocket 断线重连为什么会打爆接口:指数退避、抖动与页面恢复
- 366浏览 收藏
查看更多
课程推荐
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
查看更多
AI推荐
-
- ljg-skills
- ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
- 4986次使用
-
- MELO音乐
- MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
- 4535次使用
-
- UniScribe
- UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
- 4487次使用
-
- 剧云
- 剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
- 4740次使用
-
- 万象有声
- 万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
- 4681次使用
查看更多
相关文章
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览
-
- data-*属性详解:HTML数据存储与DOM操作技巧
- 2026-05-25 501浏览

