17370845950

JavaScript模块需显式用export/import声明且环境支持：浏览器须type="module"，Node.js须"type":"module"或.mjs；默认为脚本非模块，无自动识别；路径须带扩展名或相对/绝对前缀；export在顶层，default后不可跟函数声明；import()可动态加载但不tree-shaking。

JavaScript 模块是封装代码、隔离作用域、按需加载的基本单位，不是靠 var 或 function 声明就能自动变成模块的——必须显式使用 export 和 import，且运行环境要支持模块系统（比如浏览器启用了 type="module"，或 Node.js 启用了 "type": "module"）。

模块必须用 import / export 显式声明，不能靠文件名或位置自动识别

JS 文件默认是脚本（script），不是模块（module）。即使你把逻辑拆成多个 .js 文件，不加 export 就没有导出，不写 import 就无法导入，全局污染照旧，作用域也不隔离。

常见错误现象：

• 在 HTML 中直接 ，然后试图在另一个 script 里用 utilsHelper() —— 报错 ReferenceError: utilsHelper is not defined
• Node.js 里写 module.exports = {...}，但 package.json 没设 "type": "module"，却用 import 导入 —— 报错 ERR_REQUIRE_ESM

正确做法：

• 浏览器中：入口 script 必须带 type="module"，例如
• Node.js 中：要么加 "type": "module"，要么用 .mjs 后缀，二者选一
• 所有模块内，导出必须用 export，导入必须用 import，不混用 require() 或 module.exports

export 的三种写法和对应 import 方式

导出不是“让别人能访问变量”，而是“声明哪些绑定可以被其他模块引用”。绑定一旦导出，就与原始变量保持活连接（不是拷贝值）。

示例（math.js）：

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

对应导入方式：

• 命名导入（解构式）：import { PI, add } from './math.js';
• 重命名导入：import { add as sum } from './math.js';
• 默认导入：import multiply from './math.js';（注意：无大括号，且只能有一个 default）
• 全部导入：import * as math from './math.js'; → math.PI, math.add

⚠️ 容易踩的坑：

• export 只能出现在顶层作用域，不能在 if 或函数里
• export default 后面不能接 function 声明（会报语法错误），得写成 export default function() {...} 或 export default (a, b) => a * b;
• 命名导出必须与源文件中声明的名称完全一致，大小写敏感

动态 import() 是函数调用，不是声明，适用于条件加载

静态 import 必须在顶层、编译时确定路径；而 import() 是一个返回 Promise 的函数，可以在任意位置调用，适合按需加载、路由懒加载、错误降级等场景。

典型用法：

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

注意事项：

• import() 的参数必须是字符串字面量或模板字符串（V8 限制），不能是拼接变量，否则打包工具无法静态分析
• 它不触发 tree-shaking（因为路径不确定），但可配合 try/catch 实现 fallback
• Node.js 中支持，但需启用 --experimental-import-meta-resolve（v20.6+ 已稳定）

模块解析路径必须带扩展名或以 /、./、../ 开头

ESM 规范禁止省略扩展名（不像 CommonJS 自动尝试 .js、.json）。浏览器和现代 Node.js 都严格遵循这点。

错误写法：import { foo } from 'utils'; → 报错 Failed to resolve module specifier "utils"

正确写法（任选其一）：

• import { foo } from './utils.js';（推荐，明确、可预测）
• import { foo } from '/src/utils.js';（绝对路径，从站点根目录起）
• import { foo } from '../lib/utils.js';

⚠️ 特别注意：

• Node.js 中若用 exports 字段映射入口（如 "exports": {".": "./dist/index.js"}），那 import 'pkg' 才合法；否则必须写完整路径
• 打包工具（如 Vite、Webpack）会自动补扩展名或做别名解析，但原生 ESM 不会 —— 调试时务必确认浏览器 Network 面板里请求的是真实存在的路径

模块不是语法糖，它是运行时行为。写对 export 和 import 只是第一步，路径是否合法、环境是否启用模块模式、是否混用 CJS/ESM，任何一个环节断掉都会静默失败或报难以定位的错误。