javascript模块加载器是什么_CommonJS和ES6模块怎么选择?

11次阅读

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

javascript模块加载器是什么_CommonJS和ES6模块怎么选择?

模块加载器不是“一个东西”,而是两套运行时机制

javascript 本身没有内置的“模块加载器”——它只有 importrequire 这两个语法入口,背后真正干活的是环境提供的加载逻辑: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 包(如 lodashchalk):继续用 .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 拒绝解析该文件

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

text=ZqhQzanResources