17370845950

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 加载器。正确做法只有一条路：

• 浏览器中必须用 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 拒绝解析该文件

真正难的从来不是语法，而是搞清哪段代码由哪个加载器执行、它允许什么操作、不允许什么操作。环境边界比语法细节更值得花时间确认。