JavaScript模块加载器是环境提供的引擎级机制,非单一组件:Node.js用CommonJS或ESM加载器,浏览器仅支持ESM;选择依据是运行环境与构建链路,而非优劣比较。

模块加载器不是“一个东西”,而是两套运行时机制
JavaScript 本身没有内置的“模块加载器”——它只有 import 和 require 这两个语法入口,背后真正干活的是环境提供的加载逻辑:Node.js 的 CommonJS 加载器(CJS loader)或现代运行时的 ES 模块加载器(ESM loader)。它们不是插件,是引擎级能力,不能 runtime 替换。
- Node.js v12+ 默认用 CJS;加
type="module"或.mjs后缀才启用 ESM 加载器 - 浏览器原生只认
,不支持require(),也没 CJS 加载器 - Webpack/Vite 等打包工具会模拟加载行为,但最终输出仍需适配目标环境的加载器
CommonJS 和 ES6 模块怎么选?看运行环境和构建链路
别纠结“哪个更好”,而要看你代码在哪跑、谁在打包:
-
浏览器直接运行:必须用 ES6 模块(
import/export),否则报Uncaught ReferenceError: require is not defined -
Node.js 脚本(如 CLI 工具、脚本任务):
- 新项目:用
.mjs+type="module"+import,避免require()的动态陷阱 - 老项目/依赖大量 CJS 包(如
lodash、chalk):继续用.cjs或默认.js+require(),更稳
- 新项目:用
-
前端工程(React/Vue):一律写 ES6 模块,构建工具自动处理兼容性(比如把
import fs from 'fs'标记为 external 或 mock)
混用时最常踩的坑:循环依赖和值拷贝 vs 引用
这是两种加载器底层差异导致的真实 bug 源头,不是写法问题:
/* math.cjs */ let count = 0; exports.increment = () => ++count; exports.getCount = () => count;/ main.cjs / const { getCount, increment } = require('./math.cjs'); increment(); console.log(getCount()); // 1 // ✅ 正常:CJS 导出的是执行时的值拷贝,但函数调用仍能读取闭包变量
/ math.mjs / let count = 0; export const increment = () => ++count; export const getCount = () => count;
/ main.mjs / import { getCount, increment } from './math.mjs'; increment(); console.log(getCount()); // 1 // ✅ 也正常:ESM 导出的是实时绑定,函数和变量都共享同一份内存
- 但若你在 CJS 中导出原始值:
exports.version = '1.0';,之后改exports.version = '1.1',已require的模块看不到更新 - ESM 中
export let version = '1.0';,其他模块import { version }后,你改version = '1.1',所有导入处立刻可见 - 循环依赖时,CJS 返回空对象再逐步填充(可能拿到
undefined);ESM 保持引用,即使 A → B → A,也能安全访问已声明的绑定
动态导入只能用 import(),require() 不是万能的
很多人想在浏览器里用 require('./config.json') 加载配置,结果报错——因为浏览器根本没有 CJS 加载器。正确做法只有一条路:
立即学习“Java免费学习笔记(深入)”;
- 浏览器中必须用
import('./config.json')(返回 Promise),且文件需是合法 ESM(JSON 需开启node --experimental-json-modules或由构建工具转成 JS 对象) - Node.js 中若用 ESM,也不能用
require()加载 JSON,得写import config from './config.json' assert { type: 'json' };(v18.17+)或用await import('./config.json', { assert: { type: 'json' } }) -
require()在 ESM 文件里根本不能出现,哪怕注释掉也会让 Node.js 拒绝解析该文件
真正难的从来不是语法,而是搞清哪段代码由哪个加载器执行、它允许什么操作、不允许什么操作。环境边界比语法细节更值得花时间确认。











