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' 会语法错误。
立即学习“Java免费学习笔记(深入)”;
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 请求的响应头。











