都是JS,CJS和ESM有什么区别?

一:定义

  • CommonJS (CJS)**:**非ECMA官方规范,用于NodeJS默认加载加载模块化方式,浏览器无法运行,使用**module.exports/require**导入模块文件。
  • ESModule(ESM):ES6(ECMA)官网标准,浏览器 + Node通用模块化规范,前端工程主流方案,使用**export/import**导入模块文件。

二:使用场景

1. 模块的导入导出

|--------|---------------------------------------------------------|-------------------------------------------------------------|
| 规范 | 导出 | 导入 |
| CJS | module.exports = { a: 1, b: 2, ... } exports.a = 1 | const module = require("./xxx") |
| ESM | export const a = 1 export default = { a: 1, b: 2, ... } | import module from "./xxx" (静态、同步) import ("./xxx") (动态、异步) |

javascript 复制代码
// CJS示例
// a.js
exports.num = 1
// index.js
const { num } = require('./a')

// ESM示例
// a.js
export let num = 1
// 静态导入(顶层专用)
import { num } from './a'
// 动态导入(任意位置,返回Promise)
import('./a').then(res=>{})
2. 加载顺序

# CJS:同步加载,会阻塞代码运行。require是普通函数,代码执行到当前行才会加载该文件,支持代码动态引入。

javascript 复制代码
// CJS合法:if、for、函数内部任意位置写require
if(flag){
  const m = require('./mod1')
}else{
  const m = require('./mod2')
}

# ESM静态引入:编译时静态解析,提前写入全部模块路径,必须写在代码最顶层,代码同步加载。

javascript 复制代码
// ESM 静态文件加载
// 默认 导入
import module from "./xxx"
// 命名 导入
import { module } from "./xxx"
// 全量导入
import  * as module from "./xxx"

# ESM动态引入:可以运行时异步加载,返回Promise,import()是ES内置函数,CJS/ESM环境都能识别,任意位置都能调用,用于路由懒加载、按需引入。

javascript 复制代码
// ESM 动态导入
import("./xxx")

// Promise
import("./xxx").then(res => {
    // 业务代码
})
3. 导出值绑定:值拷贝 vs 实时绑定

# CJS :导出值的副本(浅拷贝),原模块变量变化不影响导入值

javascript 复制代码
// c.js(CJS)
let count = 1
exports.count = count
exports.add = ()=>count++

// index.js(CJS)
const {count,add}=require('./c')
console.log(count) //1
add()
console.log(count) //1(拷贝快照,原变量变了不更新)

# ESM :导出实时引用绑定,原模块值变更,导入变量自动同步更新

javascript 复制代码
// e.js(ESM)
export let count =1
export const add = ()=>count++

// index.js(ESM)
import {count,add} from './e'
console.log(count)//1
add()
console.log(count)//2(实时绑定,同步变化)
4. 静态优化能力(Tree-Shaking 关键)

# CJS :无法 Tree-Shaking,运行时动态解析依赖,打包阶段无法剔除未使用代码,打包体积偏大。

# ESM :支持 Tree-Shaking ,编译时确定导入导出,webpack/rollup 可删除未被引入的export代码,精简打包产物。

5. 顶层 this 与内置变量

# CJS:每个模块被包装成闭包函数,顶层 this = module.exports;

# ESM :顶层 this = undefined,默认开启严格模式use strict。

6. 模块缓存 & 循环依赖

# CJS :第一次require加载后缓存module.exports ,再次引入直接读缓存;循环依赖时返回未完成导出的空对象;

# ESM:通过拓扑排序解析依赖,循环依赖拿到实时引用,不会返回空对象。

7. 跨规范互导规则

ESM import CJS :只能整体默认导入,无法单独解构 CJS 命名导出。

javascript 复制代码
// cjs模块:module.exports={a:1,b:2}
import all from './cjs' //✅正确,all={a:1,b:2}
import {a} from './cjs' //❌报错,ESM不能解构CJS导出

CJS require ESM :Node 原生不支持同步require(ESM),直接报ERR_REQUIRE_ESM,只能用await import()异步引入。

三:使用场景总结

# CJS:适用于Node 后端服务、脚手架工具、老项目遗留代码;

# ESM:适用于前端 Vue/React 项目、浏览器原生模块化、新项目标准选型。

四:小结

  • CJS运行时同步加载、值拷贝、无TreeShaking;ESM编译时静态导入 + 动态import()异步、实时绑定、支持TreeShaking;
  • CJS用require/module.exports,ESM用import/export。
  • CJS环境不识别静态import,仅兼容import()动态导入。
相关推荐
默_笙7 小时前
🧀 让大模型的答案"流"出来:NestJS AI 模块 + SSE + RxJS 实战
javascript·人工智能
mbshqqb7 小时前
TypeScript基础教程之同步生成器
前端·javascript·typescript
尤水就下8 小时前
🔥预热:在线文档的 block 架构是如何实现的(未完待续...)
前端·javascript·架构
全栈项目管理程序猿8 小时前
ArcGIS JS 基础教程(29):CSVLayer 表格点位图层
前端·javascript
骑着蜗牛撵大象3279 小时前
豆包 Seed 驱动的记账智能体:从拍票抽取到月报生成的全链路落地记录
java·前端·javascript·结构化输出·豆包seed·多模态识别·记账系统
溪语流沙9 小时前
【Web全栈进阶】前端世界观:现代工具链与框架为什么存在
前端·javascript·vue.js
kyriewen9 小时前
我逐个测了 JSON.stringify 的 7 个坑:第 1 个就在丢数据
前端·javascript·程序员
song50110 小时前
React Native for OpenHarmony 实战:三方库 react-native-ratings 的鸿蒙化适配指南
javascript·react native·react.js·分类·harmonyos
朱包林10 小时前
iTerm2终端配置指南
linux·javascript·python·云原生·容器·kubernetes·云计算
谢亮_vipxieliang11 小时前
JavaScript this 指向完全指南:调用位置决定一切
开发语言·javascript·ecmascript