目录

module 与 CommonJS 有什么区别

一句话:这不是 TypeScript 发明的分裂,而是 JavaScript 自己历史上先有 CommonJS(Node 的模块方案),后有 ES Module(写进语言标准的模块),TypeScript 作为“编译到各种运行环境”的语言,必须同时服务这两套系统。

一、为什么会分成两套

所以答案是:TS 并没有主动分裂,它只是在兼容两个历史阶段。

二、核心区别

对比项 CommonJS(CJS) ES Module(ESM)
语法 require() / module.exports / exports import / export
文件判定 .cjs;package.json 没有 “type”: “module” 时的 .js .mjs;“type”: “module” 下的 .js
导出性质 导出一个对象(快照),重新赋值 module.exports 不会同步给已有引用 活绑定(live binding):导出方改变量,导入方能拿到新值
加载时机 运行时同步加载,require 可以写在 if、函数里 静态分析,先建依赖图再执行;import 只能在顶层(动态 import() 除外)
顶层 await 不支持 支持
严格模式 默认非严格,顶层 this 指向 module.exports 默认严格模式,顶层 this 是 undefined
可用变量 require、module、dirname、filename 都没有,用 import.meta.url、import.meta.dirname
循环依赖 可能拿到“还没填完”的 exports(undefined) 靠提升 + 活绑定,通常能拿到引用
tree-shaking 基本不行,打包器只能猜 结构是静态的,可以摇树,产物更小
缓存 require 有缓存,缓存的是导出对象 模块只执行一次,绑定共享

补充两点:

三、TypeScript 里对应的开关

{
  "compilerOptions": {
    "target": "es2022",
    "module": "nodenext",            // 输出哪种模块系统
    "moduleResolution": "nodenext",  // 按哪套规则解析 import
    "esModuleInterop": true,         // 让 import x from "cjs包" 能正常工作
    "verbatimModuleSyntax": true,    // 你写 import 就输出 import,不再偷偷换成 require
    "strict": true
  }
}

要点:

四、什么时候用 module(ESM),什么时候用 CommonJS

优先用 ESM(module: nodenext / esnext)

留在 CommonJS(module: commonjs)

五、互操作与常见坑

六、小结

两套模块系统是 JS 历史留下的既成事实,TS 只是把它们都支持了,并给你 module / moduleResolution 两个开关去选。实践上的取舍:新代码优先 ESM,被老环境绑住才用 CJS;项目内部保持统一,个别文件用 .mts / .cts 破例。

相关:什么是mts文件、import / export 语法、编译配置