ES6模块怎么用？导入导出详解

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《ES6模块怎么用？导入导出全解析》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

ES6模块是原生静态系统，import必须顶层声明；export default与具名export需严格匹配导入方式；Node.js启用ES模块需满足.mjs扩展名或"type":"module"；import.meta.url是获取模块路径的唯一可靠方式。

ES6 模块不是“语法糖”，而是 JavaScript 原生的、静态的模块系统；它不支持运行时动态加载（除非用 import()），也不允许在 if 或函数里写 import 语句——这是最常踩的坑。

为什么 import 必须写在顶层作用域

ES6 模块解析发生在代码执行前（即“编译期”），引擎需要静态分析依赖图。一旦把 import 放进条件分支或函数里，就破坏了这种可预测性。

• ❌ 错误写法：

  if (condition) { import { foo } from './module.js'; }

• ✅ 正确替代：import() 动态导入（返回 Promise）：

  if (condition) { import('./module.js').then(m => m.foo()); }

• 注意：import() 是函数调用，不是声明，可以出现在任意位置

export default 和具名 export 的混用陷阱

一个模块可以有且仅有一个 export default，但可以有多个具名 export；但导出和导入方式必须严格匹配，否则会报 undefined。

• 导出示例：

  export const a = 1;
  export function b() {}
  export default class C {}

• 对应导入必须分清：

  import C, { a, b } from './module.js'; // default + named
  // 不是 import { default as C, a, b }

• 常见错误：用 {} 解构导入 default —— 它没有名字，不能这样取

Node.js 中启用 ES 模块的三个硬性条件

Node.js 默认按 CommonJS 解析 .js 文件；要启用 ES 模块，必须同时满足：

• 文件扩展名是 .mjs，或
• package.json 中有 "type": "module" 字段（此时 .js 也被视为 ES 模块）
• 命令行启动时没加 --experimental-modules（该 flag 在 Node 14+ 已废弃）
• ⚠️ 特别注意：如果项目里同时存在 require() 和 import，跨模块互操作需用 createRequire 或 import.meta.url 构造路径

import.meta.url 是解决路径问题的唯一可靠方式

CommonJS 的 __dirname 和 __filename 在 ES 模块中不可用；任何基于相对路径的读取（比如 fs.readFile('./data.json')）都会以进程工作目录为基准，极易出错。

• 正确写法（获取当前模块所在目录）：

  import { fileURLToPath } from 'url';
  import { dirname } from 'path';
  const __dirname = dirname(fileURLToPath(import.meta.url));

• 直接拼接路径更安全：

  import { resolve } from 'path';
  const dataPath = resolve(new URL('.', import.meta.url).pathname, './data.json');

• 这个细节在构建工具链里常被忽略，一到部署就找不到资源文件

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~