ES Module 是当前标准，import/export 必须在顶层作用域，浏览器和 node.js（v12+）原生支持但行为不同；CommonJS 仍广泛用于 node.js，require() 是运行时函数；二者可单向互操作，混合使用需注意入口配置与路径规范。
ES Module 是当前标准，import 和 export 必须在顶层作用域
浏览器和 Node.js（v12+ 默认启用）都原生支持 ES Module，但行为有差异。关键约束是：import 不能写在 if、函数或 try 块里，否则会报 Cannot use import statement outside a module 或 Unexpected Token 'import'。
- Node.js 中需在
package.json里显式声明"type": "module"，否则即使文件后缀是.mjs，require()加载时仍按 CommonJS 解析 - 浏览器中通过
启用，此时脚本自动变为 defer 行为，且默认 CORS 安全策略更严格 - 动态导入可用
import()函数（返回 promise），它可以在任何位置调用，适合按需加载
CommonJS 在 Node.js 里仍广泛存在，require() 不是语法而是运行时函数
CommonJS 模块本质是每个文件被包裹在函数中执行，exports 和 module.exports 指向同一对象，但直接赋值 module.exports = xxx 会切断与 exports 的引用关系。
-
require('./util')返回的是module.exports的值，不是exports对象本身 - 循环依赖时，CommonJS 返回已执行部分的
exports对象（可能为空或不完整），而 ES Module 返回一个实时绑定的只读代理，访问未初始化的导出会抛ReferenceError - Node.js 允许
require()加载 JSON 和 c++ 插件，ES Module 目前不支持（需用fs.readFileSync+JSON.parse手动处理 JSON）
混合使用时注意互操作：Node.js 支持 import 加载 CommonJS，但反向不成立
Node.js 允许在 ES Module 文件中用 import 加载 CommonJS 模块，例如：
import fs from 'fs'; // CommonJS 模块，自动提取 default 导出 import { readFile } from 'fs'; // 也支持命名导入（Node.js v14.13+）但 CommonJS 文件无法直接 require() 一个纯 ES Module 文件（会报 ERR_REQUIRE_ESM）。若必须接入，可：
立即学习“Java免费学习笔记（深入）”；
- 将 ES Module 封装为 CommonJS 兼容层（在
index.cjs中用await import('./main.mjs')） - 在
package.json中设置"exports"字段，明确指定不同环境下的入口（如"import": "./dist/index.mjs","require": "./dist/index.cjs"） - 避免在
require()主链路中直接加载 .mjs —— 构建工具（如 esbuild、rollup）通常能自动处理，但运行时不行
构建工具不是必需项，但跨环境兼容常绕不开它
纯浏览器环境用 ES Module 需确保所有依赖都提供 type="module" 兼容版本；纯 Node.js 环境可选 CommonJS 或 ESM，但团队协作时统一类型更稳妥。真正棘手的是：第三方包大多同时发布两种格式，但没有强制规范其导出结构是否一致。
- 查包是否支持 ESM：看
package.json是否有"type": "module"或"exports"字段，而非仅凭文件后缀 - 某些包（如
lodash）导出的是命名空间对象，import _ from 'lodash'可行，但import { debounce } from 'lodash'可能失败——得用import debounce from 'lodash/debounce' - TS 用户注意：
tsconfig.json中"module"影响编译输出，但不改变运行时模块系统；要跑在浏览器，最终仍需type="module"脚本标签
最易被忽略的一点：ES Module 的路径必须带扩展名（./utils.js）或以 / 结尾（./hooks/），import './utils' 在浏览器中会 404；Node.js 则允许省略，但这是 Node.js 特性，不可移植。