javascript模块化开发有哪些方案_怎样使用import和export【教程】

主流模块化方案是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';重命名用 asimport { 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 必须显式

声明模块类型。

  • 方式一:在 package.json 加字段:"type": "module" —— 此后所有 .js 都按 ESM 解析
  • 方式二:用 .mjs 后缀(优先级更高,无视 type 字段)
  • CommonJS 和 ESM 不能互相 requireimport(会报错),但可通过 createRequire 在 ESM 中模拟 require,或用 import.meta.require(非标准,仅部分环境支持)
  • ESM 中 __dirname__filename 不可用,得用 import.meta.url 配合 fileURLToPath

真正容易卡住的不是语法,而是环境判断和混合模块共存——比如一个项目既有 require 又想加 import,就得面对加载器差异、循环依赖行为不一致、甚至调试器断点失效的问题。别急着“全切 ESM”,先看构建工具链和依赖是否 ready。