esm可在现代浏览器中直接运行,需满足:①script标签加type="module";②路径带扩展名且以./、../或/开头;③通过http服务器访问(不可双击打开);④模块作用域天然隔离,仅支持import/export语法。

直接用 ES Modules(ESM) 就行。现代浏览器原生支持,无需构建、不装工具、不启服务——只要满足几个关键条件,就能让 import/export 真正跑起来。
必须加 type="module" 属性
普通 script 标签不认识 import/export,只有显式声明类型,浏览器才启用模块解析器:
-
<script type="module" src="./main.js"></script>—— 推荐方式,外部模块 -
<script type="module">import { foo } from './utils.js'; console.log(foo());</script>—— 内联模块也支持 - 漏掉 type="module",哪怕语法完全正确,也会被当作普通脚本忽略 import,直接报错
路径必须带扩展名且规范
ESM 不做路径解析,不支持 Node 风格的自动补全(如 ./utils → ./utils.js):
使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- ✅ 正确:
import { log } from './logger.js'、import api from '/lib/api.mjs'、import _ from 'https://cdn.skypack.dev/lodash@4' - ❌ 报错:
import { log } from './logger'(缺 .js)、import mod from 'lodash'(非完整 URL 或相对路径) - 相对路径必须以
./、../或/开头;裸文件名utils.js会被解析成当前页面同目录,但行为不稳定,不建议
得用 HTTP 服务器(本地开发不能双击打开)
浏览器对模块脚本执行严格的 CORS 和 MIME 检查,file:// 协议下会失败:
- ❌ 双击 index.html → 控制台报错:
Access to script at 'file:///.../main.js' from origin 'null' has been blocked by CORS policy - ✅ 快速解决:用任意轻量命令行服务器,例如:
npx serve(需 npm)、python3 -m http.server 8000、或 VS Code 的 Live Server 插件 - 只要地址是
http://localhost:8000/这类,MIME 类型(application/javascript)和跨域头就自动合规
模块作用域天然隔离,无需额外封装
每个 .js 文件就是一个独立模块,顶层变量不会污染全局,也不需要 IIFE 或 define 包裹:
-
const PI = 3.14;、function helper() {}、export default class App{}都只在本模块内有效 - 导出用
export(命名导出)或export default(默认导出),导入时对应写法即可 - 没有
require、module.exports,也不支持__dirname或process等 Node 特有变量










