Node.js 中启用 ES6 模块需显式声明：一、package.json 加 "type": "module"；二、用 .mjs 后缀；三、启动时加 --input-type=module。二者不兼容，import 是静态编译期解析，require 是运行时动态加载，路径和作用域限制不同。
ES6 模块（import/export）和 CommonJS（require/module.exports）本质不兼容，不能混用；Node.js 从 v14 开始默认支持 ES6 模块需靠 .mjs 后缀或 "type": "module" 声明，否则按 CommonJS 处理。
如何在 Node.js 中正确启用 ES6 模块
Node.js 默认把 .js 文件当 CommonJS 执行。想用 import/export，必须显式开启模块模式：
- 方案一：在
package.json中添加"type": "module"—— 整个包所有.js文件都按 ES6 模块解析 - 方案二：改用
.mjs后缀 —— 单个文件生效，无需改package.json - 方案三：启动时加
--input-type=module（仅限 inline 脚本）或--experimental-modules（旧版本）
注意："type": "module" 下，require() 会直接报错 ReferenceError: require is not defined；反之，CommonJS 中也不能用 import。
import 和 require 的加载时机与行为差异
ES6 模块是静态编译期解析，CommonJS 是运行时动态加载：
立即学习“Java免费学习笔记（深入）”；
-
import必须在顶层作用域，不能写在if或函数里；require()可以随时调用 -
import的模块路径必须是字符串字面量（不能拼接变量），否则报ParseError: 'import' and 'export' may only appear at the top level -
require()返回的是模块的exports对象，可多次赋值；export是绑定导出，修改原始值会影响所有导入处（如export let count = 0，另一端import { count }后修改它，双方可见）
例如：export { foo } 导出的是对 foo 的只读绑定，不是拷贝；而 module.exports = { foo } 是一次性的值拷贝。
默认导出（export default）和命名导出（export）怎么对应 require
CommonJS 没有“默认导出”概念，所以 import something from 'x' 实际等价于 const something = require('x').default —— 这意味着，如果一个 ES6 模块只有 export default xxx，没有 export 命名项，那它的 require('x') 结果就是 xxx；但一旦同时存在 export default 和 export const y = 1，require('x') 就变成 { default: xxx, y: 1 }。
- 想让
require()直接拿到默认值？只能用module.exports = xxx，不能混用export default - 想在 ES6 模块中兼容
require？可以显式设置module.exports = xxx（Node.js 允许在.mjs中写，但不推荐） - 使用
import * as ns from 'x'时，CommonJS 模块会被包装成命名空间对象：ns.default存默认导出，ns.xxx存命名导出（如果有的话）
跨环境（浏览器 + Node.js）统一模块写法的现实约束
目前没有零配置、无妥协的通用方案。常见折中方式：
- 纯前端项目：只用
import/export，打包工具（如 Vite、Webpack）自动处理 - 纯 Node.js 工具库：若需支持旧版 Node（"type": "module" +
.mjs - 双端库（如 UI 组件）：通常提供两种构建产物：
dist/index.cjs（CommonJS）和dist/index.esm.js（ESM），并在package.json中分别指定"main"和"module"字段
真正容易被忽略的是：ES6 模块的循环引用处理机制和 CommonJS 不同——ES6 中导入的是实时绑定，可能拿到 undefined（直到模块执行完才赋值），而 CommonJS 是导出时的快照值，更“稳定”但也更死板。
