javascript的模块是什么_如何导入导出功能【教程】

export和import是ES模块的原生语法，用于显式导出和导入代码单元；export在顶层声明可被外部使用的值，import在顶层导入，路径须为字符串字面量。

JavaScript 的模块不是语法糖，是独立作用域的代码单元，导出和导入必须显式声明，否则变量函数默认不对外暴露。

什么是 export 和 import？

它们是 ES 模块（ESM）的原生语法，用于在文件间共享值、函数或类。export 决定“谁可以被别人用”，import 决定“我从哪拿东西”。CommonJS 的 module.exports 和 require() 是另一套机制，两者不兼容。

• export 必须出现在顶层作用域，不能在 if 或函数里
• import 也必须在顶层，且路径必须是字符串字面量（不能拼接变量）
• 浏览器中使用 ESM 需要 HTML 的 ，否则报错

export default 和命名导出的区别

export default 每个模块只能有一个，导入时名字随意；命名导出可多个，导入时名字必须一致（或用 as 重命名）。

/* math.js */
export const PI = 3.14;
export function add(a, b) { return a + b; }
export default function multiply(a, b) { return a * b; }

/* main.js */
import multiply from './math.js';           // ✅ 默认导出，取名自由
import { PI, add } from '
./math.js';        // ✅ 命名导出，名字需匹配
import { add as sum } from './math.js';     // ✅ 重命名也可
import * as math from './math.js';          // ✅ 全部导入为对象，math.PI、math.add 可用

注意：import multiply, { PI } from './math.js' 这种混合写法合法，但 import { PI }, multiply from './math.js' 会语法错误。

Node.js 中 ESM 和 CommonJS 混用的坑

Node.js 从 v12 起支持 ESM，但默认仍按 CommonJS 解析。启用 ESM 需满足以下任一条件：

• 文件扩展名为 .mjs
• package.json 中有 "type": "module"
• 启动时加 --input-type=module（仅限字符串输入）

一旦启用 ESM，require() 就不可用（除非用 createRequire），而 import() 动态导入返回 Promise，不能直接赋值给 module.exports。反过来，CommonJS 文件里也不能用 import 语句——哪怕只是写一行也会报 Unexpected token 'export'。

浏览器中路径解析和 MIME 类型要求

浏览器对 import 路径非常严格：

• 相对路径（./utils.js）和绝对路径（/src/index.js）都行，但不能省略扩展名（./utils 会 404）
• 第三方包如 lodash-es 必须通过完整 URL 或构建工具处理，浏览器原生不支持 bare import（import _ from 'lodash' 会失败）
• 服务器必须返回 Content-Type: text/javascript，否则 Chrome 报 Failed to load module script

开发时用 http-server -c-1 或 Vite 启服务能绕过大部分 MIME 问题；上线前务必检查网络面板里每个 .js 请求的响应头。