ES6模块是原生静态系统，import必须顶层声明；export default与具名export需严格匹配导入方式；Node.js启用ES模块需满足.mjs扩展名或"type":"module"；import.meta.url是获取模块路径的唯一可靠方式。
ES6 模块不是“语法糖”，而是 JavaScript 原生的、静态的模块系统；它不支持运行时动态加载（除非用 import()），也不允许在 if 或函数里写 import 语句——这是最常踩的坑。
为什么 import 必须写在顶层作用域
ES6 模块解析发生在代码执行前（即“编译期”），引擎需要静态分析依赖图。一旦把 import 放进条件分支或函数里，就破坏了这种可预测性。
- ❌ 错误写法：
if (condition) { import { foo } from './module.js'; } - ✅ 正确替代：
import()动态导入（返回 Promise）：if (condition) { import('./module.js').then(m => m.foo()); } - 注意：
import()是函数调用，不是声明，可以出现在任意位置
export default 和具名 export 的混用陷阱
一个模块可以有且仅有一个 export default，但可以有多个具名 export；但导出和导入方式必须严格匹配，否则会报 undefined。
- 导出示例：
export const a = 1;
export function b() {}
export default class C {} - 对应导入必须分清：
import C, { a, b } from './module.js'; // default + named
// 不是 import { default as C, a, b } - 常见错误：用
{}解构导入default—— 它没有名字，不能这样取
Node.js 中启用 ES 模块的三个硬性条件
Node.js 默认按 CommonJS 解析 .js 文件；要启用 ES 模块，必须同时满足：
立即学习“Java免费学习笔记（深入）”；
- 文件扩展名是
.mjs，或 -
package.json中有"type": "module"字段（此时.js也被视为 ES 模块） - 命令行启动时没加
--experimental-modules（该 flag 在 Node 14+ 已废弃） - ⚠️ 特别注意：如果项目里同时存在
require()和import，跨模块互操作需用createRequire或import.meta.url构造路径
import.meta.url 是解决路径问题的唯一可靠方式
CommonJS 的 __dirname 和 __filename 在 ES 模块中不可用；任何基于相对路径的读取（比如 fs.readFile('./data.json')）都会以进程工作目录为基准，极易出错。
- 正确写法（获取当前模块所在目录）：
import { fileURLToPath } from 'url';
import { dirname } from 'path';
const __dirname = dirname(fileURLToPath(import.meta.url)); - 直接拼接路径更安全：
import { resolve } from 'path';
const dataPath = resolve(new URL('.', import.meta.url).pathname, './data.json'); - 这个细节在构建工具链里常被忽略，一到部署就找不到资源文件
