详细分析Node.js 模块系统

为了让node.js的文件可以相互调用，node.js提供了一个简单的模块系统。

模块是node.js 应用程序的基本组成部分，文件和模块是一一对应的。换言之，一个 node.js 文件就是一个模块，这个文件可能是javascript 代码、json 或者编译过的c/c++ 扩展。

创建模块

在 node.js 中，创建一个模块非常简单，如下我们创建一个 main.js 文件，代码如下:

var hello = require('./hello');
hello.world();

以上实例中，代码 require('./hello') 引入了当前目录下的 hello.js 文件（./ 为当前目录，node.js 默认后缀为 js）。

node.js 提供了 exports 和 require 两个对象，其中 exports 是模块公开的接口，require 用于从外部获取一个模块的接口，即所获取模块的 exports 对象。

接下来我们就来创建 hello.js 文件，代码如下：

exports.world = function() {
 console.log('hello world');
}

在以上示例中，hello.js 通过 exports 对象把 world 作为模块的访问接口，在 main.js 中通过 require('./hello') 加载这个模块，然后就可以直接访 问 hello.js 中 exports 对象的成员函数了。

有时候我们只是想把一个对象封装到模块中，格式如下：

module.exports = function() {
 // ...
}

例如:

//hello.js 
function hello() { 
  var name; 
  this.setname = function(thyname) { 
    name = thyname; 
  }; 
  this.sayhello = function() { 
    console.log('hello ' + name); 
  }; 
}; 
module.exports = hello;

这样就可以直接获得这个对象了：

//main.js 
var hello = require('./hello'); 
hello = new hello(); 
hello.setname('byvoid'); 
hello.sayhello(); 

模块接口的唯一变化是使用 module.exports = hello 代替了exports.world = function(){}。 在外部引用该模块时，其接口对象就是要输出的 hello 对象本身，而不是原先的 exports。

服务端的模块放在哪里

也许你已经注意到，我们已经在代码中使用了模块了。像这样：

var http = require("http");

...

http.createserver(...);

node.js 中自带了一个叫做 http 的模块，我们在我们的代码中请求它并把返回值赋给一个本地变量。

这把我们的本地变量变成了一个拥有所有 http 模块所提供的公共方法的对象。

node.js 的 require 方法中的文件查找策略如下：

由于 node.js 中存在 4 类模块（原生模块和3种文件模块），尽管 require 方法极其简单，但是内部的加载却是十分复杂的，其加载优先级也各自不同。如下图所示：

从文件模块缓存中加载

尽管原生模块与文件模块的优先级不同，但是都会优先从文件模块的缓存中加载已经存在的模块。

从原生模块加载

原生模块的优先级仅次于文件模块缓存的优先级。require 方法在解析文件名之后，优先检查模块是否在原生模块列表中。以http模块为例，尽管在目录下存在一个 http/http.js/http.node/http.json 文件，require("http") 都不会从这些文件中加载，而是从原生模块中加载。

原生模块也有一个缓存区，同样也是优先从缓存区加载。如果缓存区没有被加载过，则调用原生模块的加载方式进行加载和执行。

从文件加载

当文件模块缓存中不存在，而且不是原生模块的时候，node.js 会解析 require 方法传入的参数，并从文件系统中加载实际的文件，加载过程中的包装和编译细节在前一节中已经介绍过，这里我们将详细描述查找文件模块的过程，其中，也有一些细节值得知晓。

require方法接受以下几种参数的传递：

• http、fs、path等，原生模块。
• ./mod或../mod，相对路径的文件模块。
• /pathtomodule/mod，绝对路径的文件模块。
• mod，非原生模块的文件模块。

在路径 y 下执行 require(x) 语句执行顺序：

1. 如果 x 是内置模块
   a. 返回内置模块
   b. 停止执行
2. 如果 x 以 '/' 开头
   a. 设置 y 为文件根路径
3. 如果 x 以 './' 或 '/' or '../' 开头
   a. load_as_file(y + x)
   b. load_as_directory(y + x)
4. load_node_modules(x, dirname(y))
5. 抛出异常 "not found"

load_as_file(x)
1. 如果 x 是一个文件, 将 x 作为 javascript 文本载入并停止执行。
2. 如果 x.js 是一个文件, 将 x.js 作为 javascript 文本载入并停止执行。
3. 如果 x.json 是一个文件, 解析 x.json 为 javascript 对象并停止执行。
4. 如果 x.node 是一个文件, 将 x.node 作为二进制插件载入并停止执行。

load_index(x)
1. 如果 x/index.js 是一个文件,  将 x/index.js 作为 javascript 文本载入并停止执行。
2. 如果 x/index.json 是一个文件, 解析 x/index.json 为 javascript 对象并停止执行。
3. 如果 x/index.node 是一个文件,  将 x/index.node 作为二进制插件载入并停止执行。

load_as_directory(x)
1. 如果 x/package.json 是一个文件,
   a. 解析 x/package.json, 并查找 "main" 字段。
   b. let m = x + (json main 字段)
   c. load_as_file(m)
   d. load_index(m)
2. load_index(x)

load_node_modules(x, start)
1. let dirs=node_modules_paths(start)
2. for each dir in dirs:
   a. load_as_file(dir/x)
   b. load_as_directory(dir/x)

node_modules_paths(start)
1. let parts = path split(start)
2. let i = count of parts - 1
3. let dirs = []
4. while i >= 0,
   a. if parts[i] = "node_modules" continue
   b. dir = path join(parts[0 .. i] + "node_modules")
   c. dirs = dirs + dir
   d. let i = i - 1
5. return dirs

以上就是详细分析node.js 模块系统的详细内容，更多关于node.js模块系统的资料请关注其它相关文章！