ES6模块与CommonJS对比解析

一分耕耘，一分收获！既然打开了这篇文章《ES6模块与CommonJS区别详解》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

ES6模块是静态解析的，import/export必须在顶层作用域，支持Tree-shaking；CommonJS是运行时执行，require可动态加载但不支持Tree-shaking；两者默认导出机制不同，互操作需注意default包装；Node.js中需通过文件后缀或type字段区分模块类型。

ES6 模块（import/export）是静态解析的

浏览器和现代打包工具（如 Webpack、Vite）在构建阶段就确定模块依赖关系，不允许动态决定 import 路径或条件加载（除非用 import() 动态导入）。这意味着：

if (condition) {
  import { foo } from './module.js'; // ❌ 语法错误：不能出现在 if 内
}

而 import 必须写在顶层作用域。这种静态性让 Tree-shaking 成为可能，也便于 IDE 提前校验导出名是否存在。

CommonJS（require/module.exports）是运行时执行的

require 是函数调用，可以出现在任意位置，支持拼接路径、条件引入、甚至循环依赖（虽然不推荐）：

const path = './' + env + '/config.js';
const config = require(path); // ✅ 合法（Node.js 环境下）

但这也意味着无法在构建期分析依赖，Tree-shaking 效果差；且 Node.js 中默认以 CommonJS 方式加载 .js 文件（除非 type: "module" 显式声明）。

默认导出行为不同，混用时容易出错

ES6 的 export default 导出的是一个值的**绑定引用**，而 CommonJS 的 module.exports 是一个对象的**属性赋值**：

• export default { a: 1 } → 导出的是该对象本身，修改其属性会影响所有导入者
• module.exports = { a: 1 } → 导入后得到的是该对象的拷贝（浅拷贝），后续 module.exports = ... 赋值会完全替换它

更关键的是互操作陷阱：

// commonjs.js
module.exports = { count: 0 };
// es6.js
import obj from './commonjs.js'; // ❌ 实际得到的是 { default: { count: 0 } }
// 正确写法（兼容 CommonJS 输出）：
import * as obj from './commonjs.js'; // obj.default 才是原对象
// 或用 require：
const obj = require('./commonjs.js');

Node.js 中两者共存需注意文件后缀与配置

Node.js v12+ 支持 ES6 模块，但有硬性约束：

• .mjs 文件强制按 ES 模块解析
• .js 文件默认按 CommonJS 解析，除非所在 package.json 中设置了 "type": "module"
• require() 不能直接加载 .mjs（会报错），import 也不能加载未声明 type: module 的 .js

跨类型调用必须通过 createRequire 或 dynamic import() 绕过限制，不是“写了就能用”。 实际项目中，如果用 Vite 或 Webpack，它们会自动处理差异；但在纯 Node 环境跑脚本时，模块类型不匹配是最常卡住的地方。

终于介绍完啦！小伙伴们，这篇关于《ES6模块与CommonJS对比解析》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！