17370845950

JavaScript模块是独立加载、作用域隔离、可复用的代码单元，需用type="module"、严格模式、显式export/import，路径须带扩展名且区分大小写。

JavaScript 模块就是能被独立加载、作用域隔离、可复用的代码单元。ES6 引入的 import 和 export 是标准方式，但必须在 type="module" 的上下文中运行，否则会直接报错 —— 这是绝大多数人卡住的第一步。

模块文件默认是严格模式且顶层 this 为 undefined

不用手动写 "use strict"，模块自动启用；this 不再指向全局对象（比如浏览器中不是 window），所有顶层声明（const、let、function）都不会挂到全局。这意味着：

• 多个模块里同名的 const API_URL = "https://api.example.com" 不会冲突
• export 出去的东西，必须显式声明，不能靠“赋值给 globalThis”来暴露
• CommonJS 风格的 module.exports 在原生 ES 模块中无效

export 有两种写法：命名导出和默认导出

命名导出适合导出多个值（函数、类、常量），调用方必须用对应名字导入；默认导出每个模块只能有一个，导入时可自定义名字。容易混淆的是混用场景：

/* math.js */
export const PI = 3.14159;
export function add(a, b) {
  return a + b;
}
export default function multiply(a, b) {
  return a * b;
}

对应导入要匹配：

立即学习“Java免费学习笔记（深入）”；

/* main.js */
import multiply, { PI, add } from './math.js';
// 注意：默认导出在前，命名导出用大括号包住
// ❌ 不能写成 import { multiply, PI, add } —— multiply 不是命名导出

常见错误：

• 忘记加 .js 后缀（ES 模块路径必须是完整路径或带扩展名，import {foo} from './utils' 会报 404）
• 试图在非模块脚本中使用 import（浏览器控制台直接敲会报 Cannot use import statement outside a module）
• 导出变量未初始化就导出（export let count; 合法，但若后续没赋值，导入后是 undefined）

import 不是同步执行，而是静态分析 + 异步加载

所有 import 语句必须在顶层（不能在 if 或函数里），因为浏览器/Node.js 在解析阶段就要构建依赖图。动态导入要用 import() 函数：

async function loadChart() {
  const { Chart } = await import('./chart.js');
  new Chart(...);
}

这带来几个实际影响：

• 无法按条件导入不同实现（如 if (DEV) import './mock-api.js' ❌），得用动态导入 + 判断
• 循环依赖时，模块返回的是「已初始化的导出对象引用」，而非最终值（A 导入 B，B 又导入 A → A 中看到的 B 是空壳，等 B 执行完才填满）
• Node.js 中需启用 --experimental-modules（v12+ 已默认支持，但 .mjs 后缀或 package.json 中设 "type": "module" 仍必要）

最常被忽略的一点：模块路径是相对 URL，不是 Node.js 的 CommonJS 模块解析规则。没有 node_modules 自动查找，也没有 main 字段回退 —— 路径写错、漏掉 .js、大小写不一致，在开发服务器上可能表现正常（因服务端重写），但部署到静态托管（如 GitHub Pages、Vercel）就立刻 404。