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 环境跑脚本时,模块类型不匹配是最常卡住的地方。











