ES模块是JavaScript原生模块系统，需在支持环境显式声明类型；export仅限顶层、路径须字符串字面量；import默认与命名导出混用需注意语法；模块绑定为实时引用。
ES 模块（import/export）不是“可选语法糖”，而是 JavaScript 原生模块系统，必须在支持模块的环境（如现代浏览器、Node.js ≥12 且启用 "type": "module"）中使用，否则会直接报错。
模块文件必须显式声明为模块类型
浏览器中，<script></script> 标签必须加上 type="module" 属性，否则 import/export 会被当作语法错误：
<script type="module" src="main.js"></script>
Node.js 中，要么将文件后缀改为 .mjs，要么在 package.json 中设置：
{ "type": "module" }
不满足任一条件，运行时会抛出 ReferenceError: require is not defined 或 SyntaxError: Unexpected token 'export'。
立即学习“Java免费学习笔记（深入）”；
export 的三种写法和关键限制
export 只能出现在模块顶层（不能在 if、函数或块级作用域内），且不能用在表达式上下文里。常见写法包括：
-
export const foo = 42;—— 命名导出，可多次 -
export function bar() {}—— 函数/类也可直接导出 -
export { foo, bar };—— 重命名导出：export { foo as baz }; -
export default function() {}—— 每个模块最多一个默认导出，接收时不需大括号
注意：export default 后不能跟 var/let/const 声明（如 export default const x = 1 是非法的），只能跟表达式或函数/类声明。
import 的路径必须是字符串字面量
import 的模块说明符（即引号里的路径）必须是静态字符串，不支持变量拼接或动态计算：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
import { foo } from './utils.js'; // ✅ 正确
const path = './utils.js';<br>import { foo } from path; // ❌ SyntaxError
动态导入要用 import() 函数（返回 Promise）：
const mod = await import('./utils.js'); // ✅ 动态导入，路径可为变量
但 import() 不能用于顶层（只能在函数或 async 上下文中），也不能替代静态 import 做常规依赖管理。
默认导出和命名导出混用时的导入写法容易混淆
假设 math.js 写了：
export const PI = 3.14;<br>export default function add(a, b) { return a + b; }
那么正确导入方式是：
import add, { PI } from './math.js'; // ✅ 默认导出 + 命名导出
不能写成：
import { add, PI } from './math.js'; // ❌ add 不是命名导出，是默认导出
也不能写成：
import add from './math.js'; // ✅ 可以，但 PI 就访问不到
更隐蔽的坑：如果只用了命名导出，却误加了 default，比如 import { default as add } from './math.js'，会报 undefined —— 因为 default 是关键字，不是导出名。
模块解析路径是相对当前文件的，不是执行位置；循环依赖时，导出对象是“实时绑定”的（修改导出值，导入方看到的也会变），这点和 CommonJS 的拷贝值不同——实际调试时容易忽略这个差异。
