Node.js 模块系统入门

在编程领域中，模块是自包含的功能单元，可以跨项目共享和重用。它们使开发人员的生活更加轻松，因为我们可以使用它来增加应用程序的功能，而不必亲自编写这些功能。它还让我们可以组织和解耦代码，从而使应用程序更容易理解、调试和维护。

在本文中，我们来探究如何使用 Node.js 中的模块，主要介绍如何导出和导入。

不同的模块格式

由于JavaScript 最初没有模块的概念，随着时间的推移出现了各种相互竞争的格式。以下是主流的几种格式：

• Asynchronous Module Definition (AMD)格式， 用于浏览器端，使用 define 函数定义模块。
• CommonJS (CJS) 格式，用于 Node.js，使用 require 和 module.exports 定义依赖和模块。
•  ES Module (ESM) 格式。从 ES6 (ES2015)开始，JavaScript 支持原生模块格式。它使用export 关键字导出模块的公开 API，并用 import 关键字导入。
•  System.register 格式被设计用于在ES5 中 支持 ES6 模块。
•  Universal Module Definition (UMD) 格式，在浏览器和 Node.js 中都可以使用。当模块需要被多种模块加载程序导入时，这个很有用。

请注意，本文只讨论 CommonJS 格式，它是Node.js 中的标准格式。如果你想深入了解其他格式，我推荐你阅读这篇文章，作者是 SitePoint 的 Jurgen Van de Moere。

加载模块

Node.js 有一系列的内置模块，我们在代码中无需安装即可使用。为此，我们需要使用require关键字加载这个模块，并把它赋值给一个变量。这样就可以调用模块暴露的任何方法了。

例如，要列出目录的内容，你可以使用文件系统模块 的 readdir 方法：

const fs = require('fs');
const folderPath = '/home/jim/Desktop/';

fs.readdir(folderPath, (err, files) => {
  files.forEach(file => {
    console.log(file);
  });
});

注意，在 CommonJS 里，模块是按照出现的顺序同步加载和处理的。

创建和导出模块

现在我们来看看如何创建模块并导出，以便在程序的其他地方使用。先创建一个 user.js 文件，并添加如下内容。

const getName = () => {
  return 'Jim';
};

exports.getName = getName;

然后在同一个目录中创建一个 index.js 文件，添加以下内容：

const user = require('./user');
console.log(`User: ${user.getName()}`);

用命令node index.js 运行程序，你应该会在控制台看到如下输出：

User: Jim

这里发生了什么？如果你查看一下user.js文件，你会注意到我们定义了一个getName函数，然后使用exports关键字使其可以在其他地方导入。然后是 index.js文件，我们导入了这个方法并执行它。还要注意的是在require 语句中，模块名字加了前缀 ./，因为它是本地文件。另外就是不需要加文件扩展名。

导出多个方法和值

我们可以用同样的方式导出多个方法和值：

const getName = () => {
  return 'Jim';
};

const getLocation = () => {
  return 'Munich';
};

const dateOfBirth = '12.01.1982';

exports.getName = getName;
exports.getLocation = getLocation;
exports.dob = dateOfBirth;

 index.js 文件：

const user = require('./user');
console.log(
  `${user.getName()} lives in ${user.getLocation()} and was born on ${user.dob}.`
);

上面的代码结果如下：

Jim lives in Munich and was born on 12.01.1982.

注意，我们为导出的dateOfBirth变量指定的名称可以是任何我们想要的名称(本例中为dob)。它不必与原来的变量名相同。

多种语法形式

还需要提到的是，你可以在中途导出方法和值，并不一定要在文件末尾。
例如：

exports.getName = () => {
  return 'Jim';
};

exports.getLocation = () => {
  return 'Munich';
};

exports.dob = '12.01.1982';

另外要感谢解构赋值，我们可以根据需要选择性导入：

const { getName, dob } = require('./user');
console.log(
  `${getName()} was born on ${dob}.`
);

如你所料，这会输出日志：

Jim was born on 12.01.1982.

导出默认值

在上面的例子中，我们分别导出了函数和值。这对于整个应用程序都需要的辅助函数来说是很方便的，但是当你的模块只导出单个对象时，通常使用module.exports：

class User {
  constructor(name, age, email) {
    this.name = name;
    this.age = age;
    this.email = email;
  }

  getUserStats() {
    return `
      Name: ${this.name}
      Age: ${this.age}
      Email: ${this.email}
    `;
  }
}

module.exports = User;

 index.js文件：

const User = require('./user');
const jim = new User('Jim', 37, 'jim@example.com');

console.log(jim.getUserStats());

上面的代码输出日志：

Name: Jim
Age: 37
Email: jim@example.com

 module.exports 和 exports 的区别是什么

你在网上可能会遇到以下语法：

module.exports = {
  getName: () => {
    return 'Jim';
  },

  getLocation: () => {
    return 'Munich';
  },

  dob: '12.01.1982',
};

这里我们把要导出的函数和值赋给 module 的 exports 属性——当然这也是可以的：

const { getName, dob } = require('./user');
console.log(
  `${getName()} was born on ${dob}.`
);

输出日志如下：

Jim was born on 12.01.1982.

那么， module.exports和 exports之间的区别到底是什么？后者只是个别名吗？

嗯，有一点，但不完全是。

为了说明我的意思，让我们更改index.js 中的代码，输出module的值：

console.log(module);

输出结果为：

Module {
  id: '.',
  exports: {},
  parent: null,
  filename: '/home/jim/Desktop/index.js',
  loaded: false,
  children: [],
  paths:
   [ '/home/jim/Desktop/node_modules',
     '/home/jim/node_modules',
     '/home/node_modules',
     '/node_modules' ] }

可以看到，module 有一个exports 属性。让我们再加点东西：

// index.js
exports.foo = 'foo';
console.log(module);

这会输出：

Module {
  id: '.',
  exports: { foo: 'foo' },
  ...

给exports 添加属性，也会添加到 module.exports。这是因为exports是module.exports的一个引用。

我应该用哪个？

既然 module.exports 和 exports 都指向同一个对象，你使用哪一个通常无关紧要。例如：

exports.foo = 'foo';
module.exports.bar = 'bar';

这段代码将会使模块的导出对象变成{ foo: 'foo', bar: 'bar' }。

不过，这里有个需要注意的地方。你赋值给module.exports的内容将成为模块导出的值。

举例如下：

exports.foo = 'foo';
module.exports = () => { console.log('bar'); };

这样只会导出一个匿名函数。foo变量将被忽略。

如果你想了解更多，我推荐你阅读 这篇文章。

总结

模块已经成为 JavaScript 生态系统不可分割的一部分，它让我们能用更小的部分组成大型程序。我希望本文为你在 Node.js 中使用模块做了良好介绍，以及帮助你了解模块语法。