Node.js ES Modules 模块-JavaScript中文网-JavaScript教程资源分享门户

引入ES Modules

在早期的Node.js版本中，开发者主要使用CommonJS模块系统。然而，随着ECMAScript规范的发展，ES Modules成为了一种更为现代和标准的方式。ES Modules引入了import和export关键字，为模块化编程提供了更清晰和强大的支持。

什么是ES Modules？

ES Modules是JavaScript的一种模块化机制，它允许你将代码分割成独立的、可重用的模块。每个模块都有自己的作用域，外部无法直接访问其内部变量，除非通过显式的导出和导入操作。

如何启用ES Modules

Node.js默认情况下并不支持ES Modules，但可以通过以下几种方式启用：

1. 使用文件扩展名

在文件路径中使用.mjs作为扩展名。这种方式是最直接的，但可能会导致一些与现有项目结构不兼容的问题。

// example.mjs
export const name = 'Alice';

2. 使用"type": "module"

在package.json文件中添加一个type字段，并将其值设置为"module"。这种方法更灵活，可以让你在同一个项目中同时使用CommonJS和ES Modules。

{
  "name": "example",
  "version": "1.0.0",
  "type": "module"
}

3. 使用`--experimental-modules`标志

启动Node.js时，使用--experimental-modules标志。这种方式适用于那些暂时不想修改package.json或更改文件扩展名的情况。

node --experimental-modules your-script.mjs

导出模块

在ES Modules中，你可以通过export关键字来暴露函数、对象或其他数据，以便其他模块可以导入它们。有两种主要的导出形式：命名导出和默认导出。

命名导出

命名导出允许你定义多个导出项，每个导出项都具有一个名称。

// math-utils.js
export function add(x, y) {
  return x + y;
}

export function subtract(x, y) {
  return x - y;
}

默认导出

默认导出允许你仅导出一个默认项。在一个模块中只能有一个默认导出。

// logger.js
const log = (message) => console.log(message);

export default log;

导入模块

一旦你有了导出的模块，就可以使用import关键字来导入它们。

导入命名导出

你可以使用花括号{}来导入命名导出。

// main.js
import { add, subtract } from './math-utils.js';

console.log(add(5, 3)); // 输出: 8
console.log(subtract(5, 3)); // 输出: 2

导入默认导出

对于默认导出，导入时不需要使用花括号。

// main.js
import log from './logger.js';

log('Hello, world!');

同时导入默认导出和其他命名导出

如果你需要同时导入默认导出和其他命名导出，可以这样做：

// main.js
import log, { add, subtract } from './math-utils.js';

log('Hello, world!');
console.log(add(5, 3));
console.log(subtract(5, 3));

动态导入

除了静态导入之外，ES Modules还支持动态导入。这种导入方式允许你在运行时根据条件来加载模块。

// main.js
if (someCondition) {
  import('./dynamic-module.js').then(({ default: module }) => {
    module.run();
  }).catch(err => {
    console.error('Failed to load module:', err);
  });
}

总结

通过本文档，你应该对如何在Node.js中使用ES Modules有了基本的理解。ES Modules提供了一种更现代化和标准化的方式来组织你的代码，使你的应用程序更加模块化和易于维护。随着Node.js版本的不断更新和发展，ES Modules的使用将会越来越广泛，因此掌握它们是非常重要的。

Node.js ES Modules 模块