模块化规范:ESM与CJS 的差异

基本概念

ESM(ECMAScript Modules)CJS(CommonJS) 是 JavaScript 中两种不同的模块系统。它们的设计目标、语法和使用场景有所不同。以下是它们的主要差异:


1. 语法差异

(1) ESM

  • 导出模块 :使用 export 关键字。

    javascript 复制代码
    // 导出变量
    export const name = "Alice";
    
    // 导出函数
    export function greet() {
      console.log("Hello!");
    }
    
    // 默认导出
    export default function() {
      console.log("Default export");
    }
  • 导入模块 :使用 import 关键字。

    javascript 复制代码
    // 导入命名导出
    import { name, greet } from './module.js';
    
    // 导入默认导出
    import myFunction from './module.js';

(2) CJS

  • 导出模块 :使用 module.exportsexports

    javascript 复制代码
    // 导出变量
    exports.name = "Alice";
    
    // 导出函数
    module.exports.greet = function() {
      console.log("Hello!");
    };
    
    // 默认导出
    module.exports = function() {
      console.log("Default export");
    };
  • 导入模块 :使用 require 函数。

    javascript 复制代码
    // 导入模块
    const myModule = require('./module');
    
    // 使用导出的内容
    console.log(myModule.name);
    myModule.greet();

2. 加载方式

(1) ESM

  • 静态加载 :ESM 是静态的,模块的依赖关系在代码解析阶段就确定了。

    • import 语句必须位于模块的顶层,不能动态加载。
    • 支持静态分析,便于工具进行优化(如 Tree Shaking)。
  • 异步加载 :ESM 支持异步加载模块(通过 import() 动态导入)。

    javascript 复制代码
    import('./module.js').then(module => {
      module.greet();
    });

(2) CJS

  • 动态加载 :CJS 是动态的,模块的依赖关系在运行时确定。

    • require 可以在代码的任何地方调用,甚至可以动态加载模块。
    • 不支持静态分析,难以进行 Tree Shaking。
    javascript 复制代码
    if (condition) {
      const myModule = require('./module');
      myModule.greet();
    }

3. 运行环境

(1) ESM

  • 浏览器 :ESM 是浏览器的原生模块系统,可以直接在浏览器中使用。

    html 复制代码
    <script type="module" src="app.js"></script>
  • Node.js :从 Node.js 12 开始,ESM 得到了原生支持,但需要使用 .mjs 文件扩展名或在 package.json 中设置 "type": "module"

    json 复制代码
    {
      "type": "module"
    }

(2) CJS

  • Node.js:CJS 是 Node.js 的默认模块系统,广泛用于服务器端开发。
  • 浏览器:CJS 不是浏览器的原生模块系统,需要通过打包工具(如 Webpack、Browserify)转换为浏览器可用的代码。

4. 性能

(1) ESM

  • 静态分析:ESM 支持静态分析,便于工具进行优化(如 Tree Shaking),减少最终打包体积。
  • 异步加载:ESM 支持异步加载模块,适合现代 Web 应用的按需加载需求。

(2) CJS

  • 动态加载:CJS 的动态加载特性使得静态分析和优化变得困难,可能导致打包体积较大。
  • 同步加载:CJS 是同步加载模块的,不适合浏览器环境中的按需加载需求。

5. 互操作性

(1) ESM 导入 CJS

  • 在 ESM 中可以导入 CJS 模块,但需要注意:

    • CJS 模块的默认导出需要通过 default 属性访问。
    javascript 复制代码
    import cjsModule from './cjs-module.js';
    console.log(cjsModule.default);

(2) CJS 导入 ESM

  • 在 CJS 中无法直接导入 ESM 模块(Node.js 中需要使用 import() 动态导入)。

    javascript 复制代码
    import('./esm-module.mjs').then(module => {
      console.log(module.default);
    });

6. 其他差异

(1) 顶层 this

  • ESM :顶层 thisundefined
  • CJS :顶层 thisexports 对象。

(2) 严格模式

  • ESM:默认启用严格模式。
  • CJS :默认不启用严格模式,需要手动添加 "use strict"

(3) 循环依赖

  • ESM:支持循环依赖,但行为与 CJS 不同。
  • CJS:支持循环依赖,但可能导致未完全初始化的模块。

总结对比

特性 ESM(ECMAScript Modules) CJS(CommonJS)
语法 import / export require / module.exports
加载方式 静态加载,支持异步动态加载 动态加载
运行环境 浏览器原生支持,Node.js 12+ 支持 Node.js 默认模块系统
性能 支持静态分析,适合 Tree Shaking 动态加载,难以优化
互操作性 可以导入 CJS 模块 无法直接导入 ESM 模块
顶层 this undefined exports 对象
严格模式 默认启用 默认不启用
循环依赖 支持,行为与 CJS 不同 支持,可能导致未完全初始化的模块

选择建议

  • ESM:适合现代浏览器环境和 Node.js 12+,支持静态分析和异步加载,适合构建现代 Web 应用。
  • CJS:适合 Node.js 环境,尤其是需要动态加载模块的场景。
相关推荐
朱昆鹏38 分钟前
开源 Claude Code + Codex + 面板 的未来vibecoding平台
前端·后端·github
lyrieek43 分钟前
pgadmin的导出图实现,还在搞先美容后拍照再恢复?
前端
永远是我的最爱1 小时前
基于.NET的小小便利店前台收银系统
前端·sqlserver·.net·visual studio
从文处安1 小时前
「九九八十一难」第一难:前端数据mock指南(TS + VUE)
前端
Zhencode1 小时前
Vue3 响应式依赖收集与更新之effect
前端·vue.js
x-cmd1 小时前
[x-cmd] jsoup 1.22.1 版本发布,引入 re2j 引擎,让 HTML 解析更安全高效
前端·安全·html·x-cmd·jsoup
天下代码客2 小时前
使用electronc框架调用dll动态链接库流程和避坑
前端·javascript·vue.js·electron·node.js
weixin199701080162 小时前
【性能提升300%】仿1688首页的Webpack优化全记录
前端·webpack·node.js
冰暮流星2 小时前
javascript之数组
java·前端·javascript
晚霞的不甘3 小时前
Flutter for OpenHarmony天气卡片应用:用枚举与动画打造沉浸式多城市天气浏览体验
前端·flutter·云原生·前端框架