Nodejs极简入门教程（一）：模块机制

JavaScript 规范（ECMAScript）没有定义一套完善的能适用于大多数程序的标准库。CommonJS 提供了一套 JavaScript 标准库规范。Node 实现了 CommonJS 规范。

模块基础

在 Node 中，模块和文件是一一对应的。我们定义一个模块：

代码如下:

// circle.js
var PI = Math.PI;
 
// 导出函数 area
exports.area = function(r) {
    return PI * r * r;
}
 
// 导出函数 circumference
exports.circumference = function(r) {
    return 2 * PI * r;
};

这里将需要导出的函数加入到 exports 对象。模块的局部变量外部无法访问（例如，上例中的 PI 变量）。调用 require 载入模块 circle.js：

代码如下:

var circle = require('./circle.js');
console.log('The area of a circle of radius 4 is '
           + circle.area(4));

附带提及一下的是，模块中，存在一个 module 对象，表示模块本身，exports 则为 module 的属性。

模块的加载

Node 会对加载过的模块进行缓冲，避免再次加载的开销：

代码如下:

// test.js
console.log("I'm here");

多次加载模块 test.js

代码如下:

// 仅仅输出一次 "I'm here"
require('./test');
require('./test');

当加载文件没有后缀时，Node 会尝试添加后缀并加载：

1..js（JavaScript 源文件）
2..node（C/C++ 扩展模块）
3..json（JSON 文件）

模块主要有几类：

1.核心模块。核心模块已经被编译到了 Node 中，我们在其源码中的 lib 目录可以找到这些核心模块。常见的核心模块：net、http、fs 模块等

2.文件模块。文件模块通过一个相对或者绝对路径加载，例如我们上面看到的 circle.js

3.自定义模块。自定义模块位于 node_modules 目录中，我们通过 npm 安装的各种模块就放置在 node_modules 目录中

核心模块总是优先被加载，假如有一个自定义模块 http，那么加载时仍然会加载核心模块 http 而非自定义模块 http。在加载自定义模块时，首先查找当前目录下的 node_modules 目录，而后查找父目录下的 node_modules 目录，以此类推，直到根目录。

require 加载的模块不是一个文件，而是一个目录时，这样的目录被叫做包（package）。包中存在一个名为 package.json 的文件（包描述文件），例如：

代码如下:

{ "name" : "some-library",
  "main" : "./lib/some-library.js" }

其中 main 指出需要被加载的模块。如果包中不存在 package.json 或者 package.json 中未指定 main 模块，那么 Node 将会尝试加载 index.js、index.node、index.json。

在加载 JavaScript 模块时，被加载的模块被包裹在一个函数中：

代码如下:

function(module, exports, __filename, __dirname, ...) {
    JavaScript module
}

每个 JavaScript 模块访问到的 module、exports、__filename、__dirname 等实际上是通过函数参数传递进来的。由于这种包裹，才使得模块的局部变量外部无法访问。但有时候也会出现让人难以理解的问题，例如：

test1.js

代码如下:

exports = {
    name: 'Name5566',
}

test2.js

代码如下:

module.exports = {
    name: 'Name5566',
}

加载这两个模块：

代码如下:

var test1 = require('./test1.js');
console.log(test1.name); // undefined
var test2 = require('./test2.js');
console.log(test2.name); // Name5566

exports 作为参数传递给模块，我们通过 exports.x 自然可以给 exports 对象添加属性（或方法），但直接给 exports 赋值（例如，exports = x）仅仅是改变了形参而非实参的值，因此：

1.为 exports 添加属性时，使用 exports
2.为 exports 赋值时，使用 module.exports

包

按 CommonJS 的规范，一个完整的包应该包含有：

1.package.json 包描述文件
2.bin 二进制文件目录
3.lib JavaScript 代码目录
4.doc 文档目录
5.test 测试代码目录

NPM 是一个 Node 的一个包管理工具。常见用法：

查看命令的文档：

代码如下:

npm help install

查看命令 install 的文档。

安装一个包：

代码如下:

npm install redis

安装 redis 这个包。install 命令会将包安装在当前目录下的 node_modules 目录中。

移除一个包：

代码如下:

npm remove redis

移除 redis 这个包。remove 命令会将当前目录下的包移除掉。