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。











