node 学习笔记 - Modules 模块加载系统 (1)
本文同步自我的个人博客：http://www.52cik.com/2015/12/11/learn-node-modules-path.html
用了这么久的 require，但却没有系统的学习过 node 的模块系统，今天就翻官方文档系统的学习下。
循环引用
node 对模块循环引用做了相应的处理，防止无尽的循环。
官方例子：
a.js:
console.log('a starting');
exports.done = false;
var b = require('./b.js');
console.log('in a, b.done = %j', b.done);
exports.done = true;
console.log('a done');
b.js:
console.log('b starting');
exports.done = false;
var a = require('./a.js');
console.log('in b, a.done = %j', a.done);
exports.done = true;
console.log('b done');
main.js:
console.log('main starting');
var a = require('./a.js');
var b = require('./b.js');
console.log('in main, a.done=%j, b.done=%j', a.done, b.done);
执行结果：
$ node main.js
main starting
a starting
b starting
in b, a.done = false
b done
in a, b.done = true
a done
in main, a.done=true, b.done=true
在结果中可以看到，b 里引用 a 的时候结果是 a.done = false，这就算文档里说的 unfinished copy，这样就避免了程序的死循环。
核心模块
其实就是被编译到 node 内部的一些模块，在源码的 lib 目录下可以找到。例如 require('http') 的时候不论是否有其他同名模块，都直接返回 node 的核心模块，也就算最高优先级。
这些模块就是 node 官网文档目录列表里的那些模块。
文件模块
这个花样就多了，慢慢说吧。
模块后缀
node 默认支持 .js .json .node 后缀的模块，也就是说 require 的时候不需要写后缀名。例如 require('./a')，node 会先尝试当前目录下的 a.js 文件，如果有，就载入否则继续尝试 a.json, a.node 这些文件，如果都不存在，就会抛出模块未找到的错误。
当然这些模块后缀都是可以自己定义拓展的，比如 ejs 就拓展了个 .ejs 的后缀，支持直接 require 就得到了编译好的模块引擎了。
模块路径
以 '/', './' 或 '../' 开头的，都是指定路径加载。
模块以 '/' 为前缀，则表示绝对路径。例如，require('/home/marco/foo.js') 加载的是 /home/marco/foo.js 这个文件。
模块以 './' 为前缀，则路径是相对于当前文件的。也就是说，circle.js 必须和 foo.js 在同一目录下，require('./circle') 才能找到。
其实还一个特殊路径的模块加载，就是 node_modules 文件夹，这个要单独说了。
从 node_modules 目录中加载
如果模块不是以 '/', './' 或 '../' 开头的，那么 node 会从当前模块的父目录开始，尝试在它的 node_modules 文件夹里加载相应模块。如果没有找到，那么就再向上移动到父目录，直到到达顶层目录位置。
假如 /home/ry/projects/foo.js 调用了 require('bar.js') 那么node查找的位置依次为：
- /home/ry/projects/node_modules/bar.js
- /home/ry/node_modules/bar.js
- /home/node_modules/bar.js
- /node_modules/bar.js
如果都找不到，会去全局模块路径找，还找不到就会抛出模块未找到的错误。
目录模块
当一个模块功能多代码多的时候，不合适写到一个文件里，那这个时候就可以用目录当作模块使用了。有两种方法可以让一个目录作为 require 方式引入。官网说三种，其实吧 .js .node 看做两种了。
index.js 入口
例如在 some-library 目录里有 index.js 或者 index.node 文件，那么 require('./some-library') 就将尝试加载下面的文件：
- ./some-library/index.js
- ./some-library/index.node
非常简单方便。
package.json
还有一种方式可以指定入口文件，就是通过 package.json，下面是一个 package.json 文件的示例。
{
"name" : "some-library",
"main" : "./src/some-library.js"
}
那么 require('./some-library') 就将会去加载 ./some-library/src/some-library.js。
全局模块
当以上方法找不到模块时，node 会去全局配置下寻找全局模块：
- $HOME/.node_modules
- $HOME/.node_libraries
- $PREFIX/lib/node
以及
- /usr/lib/node_modules
或者
- /usr/local/lib/node_modules
这些都没测试，我只知道我本地的全局模块路径是 /usr/local/lib/node_modules，是我本机 npm 安装的全局模块路径。
官网里还有一些奇葩的全局目录，我都没见过，算了不研究了。
