主流模块化方案是ES Module和CommonJS;浏览器需用type="module"或.mjs后缀,且须本地服务器运行;Node.js需配置"type": "module"或.mjs后缀才能启用ESM。

JavaScript 模块化开发目前主流方案只有两个:ES Module(import/export)和 CommonJS(require/module.exports),其他如 AMD、UMD 已基本退出日常开发。浏览器原生支持的是 ES Module,Node.js 从 v12 起默认启用 ESM,但需注意文件扩展名或 type 字段配置。
怎样让 import/export 在浏览器里跑起来
浏览器只认 .mjs 后缀或 的 script 标签,否则会报 Unexpected token 'export' 或 Cannot use import statement outside a module。
-
index.html中必须写成: - 直接双击打开 HTML 文件会触发 CORS 错误(因为浏览器把本地
file://当作不同源),必须用本地服务器启动,比如npx serve或 VS Code 的 Live Server 插件 - 路径必须是相对或绝对 URL,不支持 Node.js 风格的包名解析:
import { foo } from 'lodash'会失败,除非用构建工具或导入 CDN 地址(如https://cdn.skypack.dev/lodash@4)
import 和 export 的常见写法与陷阱
export 有命名导出和默认导出两种,二者不能混用在同一个语句中,且 import 必须对应匹配,否则会静默失败或报错。
- 命名导出必须用大括号:
import { foo, bar } from './utils.js';重命名用as:import { foo as myFoo } from './utils.js' - 默认导出只能有一个,导入时不用大括号:
import something from './utils.js';名字可任意取,不依赖原文件中的函数/变量名 - 不能在条件语句或函数作用域内使用
import(语法错误),动态导入要用import()函数形式:const mod = await import('./feature.js') -
export default function() {}后面不能加分号,否则会变成导出undefined
Node.js 中启用 ESM 的关键配置
Node.js 默认把 .js 文件当 CommonJS 处理,想用 import/export 必须显式声明模块类型。
立即学习“Java免费学习笔记(深入)”;
- 方式一:在
package.json加字段:"type": "module"—— 此后所有.js都按 ESM 解析 - 方式二:用
.mjs后缀(优先级更高,无视type字段) - CommonJS 和 ESM 不能互相
require或import(会报错),但可通过createRequire在 ESM 中模拟require,或用import.meta.require(非标准,仅部分环境支持) - ESM 中
__dirname和__filename不可用,得用import.meta.url配合fileURLToPath
真正容易卡住的不是语法,而是环境判断和混合模块共存——比如一个项目既有 require 又想加 import,就得面对加载器差异、循环依赖行为不一致、甚至调试器断点失效的问题。别急着“全切 ESM”,先看构建工具链和依赖是否 ready。











