JavaScript模块使用教程｜导出导入详解

JavaScript模块远不止是语法糖，而是运行时真实隔离的作用域单元，需通过`type="module"`显式声明，自动启用严格模式与defer执行，并严格要求路径带扩展名、依赖本地服务器运行；其导出导入机制基于实时绑定与单例保障——多次导入同一模块不会重复执行，修改导出的let变量会即时反映在所有导入处，循环依赖也能安全处理；动态import()支持按需加载，而Node.js中ESM与CommonJS混用则充满陷阱，从路径解析规则、内置变量缺失到第三方包兼容性，真正挑战在于理解底层运行时行为差异而非表面语法。

JavaScript 模块就是能独立封装变量、函数、类，并控制哪些内容对外暴露的脚本文件——不是语法糖，是运行时真实隔离的作用域单元。

模块必须用 type="module" 才生效

浏览器中直接写 默认是非模块环境，export 会报 Uncaught SyntaxError: Unexpected token 'export'。必须显式声明：

<script type="module" src="a.js"></script>

注意：type="module" 脚本默认是 defer 行为（按顺序下载、DOM 解析完才执行），且自动启用严格模式。

• 不能用 file:// 协议直接双击打开（会触发 CORS 错误），得用本地服务器（如 npx serve 或 VS Code Live Server）
• 模块路径必须带扩展名（import { foo } from './utils.js'），不支持自动补 .js
• 相对路径以当前模块文件为基准，不是 HTML 页面位置

export 的三种写法和导出对象本质

所有 export 最终都挂载到模块的 exports 对象上，只是语法糖不同：

• export const a = 1 → 命名导出，可批量重命名导入：import { a as A } from './x.js'
• export default function() {} → 默认导出，一个模块只能有一个，导入时名字任意：import anyName from './x.js'
• export { a, b as B } → 重新导出已有声明，不创建新绑定（改原值，导入处也同步变）

注意：export default 后面不能接 function 声明（会报错），要写成 export default function foo() {} 或 export default function() {}（匿名）或 const foo = () => {} + export default foo。

import 不是“加载一次”，而是绑定+单例

多次 import 同一路径，不会重复执行模块代码，也不会重复初始化顶层变量：

/* counter.js */
let count = 0
export function inc() { return ++count }
export const now = Date.now()

/* a.js */ import { inc } from './counter.js'; inc() // → 1
/* b.js */ import { inc, now } from './counter.js'; console.log(inc(), now) // → 2, 同一个时间戳

• 导入的是实时绑定（live binding），不是值拷贝：如果导出的是 let 变量，修改它，所有导入处都能看到新值
• 循环依赖能工作，但未执行完的模块返回空对象（{}），后续赋值才可见
• 动态 import() 返回 Promise，可用于按需加载，且路径可以是表达式：import(`./pages/${page}.js`)

Node.js 里模块路径和 CommonJS 混用容易崩

Node.js 14+ 默认仍用 CommonJS（require() / module.exports），启用了 ESM 需满足至少一项：.mjs 后缀、package.json 中 "type": "module"、或命令行加 --input-type=module。

• ESM 中不能用 require()，CommonJS 中不能用 import（除非用 dynamicImport 包）
• __dirname 和 __filename 在 ESM 中不存在，要用 import.meta.url + fileURLToPath()
• 第三方包若只有 CommonJS 版本（无 "exports" 字段或 "type": "module"），在 ESM 项目中 import 它会失败，需配 node --experimental-loader ts-node/esm 类工具转译

真正麻烦的不是语法，是模块解析规则和运行时行为差异——比如浏览器里 import 路径必须带 ./ 或 ../，而 Node.js ESM 允许省略（但仅限内置模块和 node_modules 中的包）。

理论要掌握，实操不能落！以上关于《JavaScript模块使用教程｜导出导入详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！