摘要：例如指定一些依賴到模塊中實現規范的模塊化，感興趣的可以查看的文檔。

CommonJS 定義了 module、exports 和 require 模塊規范，Node.js 為了實現這個簡單的標準，從底層 C/C++ 內建模塊到 JavaScript 核心模塊，從路徑分析、文件定位到編譯執行，經歷了一系列復雜的過程。簡單的了解 Node 模塊的原理，有利于我們重新認識基于 Node 搭建的框架。

CommonJS 規范或標準簡單來說是一種理論，它期望 JavaScript 可以具備跨宿主環境執行的能力，不僅可以開發客戶端應用，還可以開發服務端應用、命令行工具、桌面圖形界面應用等。

CommonJS 規范對模塊的定義分為三個部分：

模塊定義

在模塊中存在module對象代表模塊本身，模塊上下文提供exports屬性 ，將方法掛載在exports對象上即可以定義導出方式，例如：

    // math.js
   exports.add = function(){ //...}

模塊引用

module提供require()方法引入外部模塊的 API 到當前的上下文中：

   var math = require("math")

模塊標識

模塊標識實際就是傳遞給require()方法中的參數，可以是按小駝峰（camelCase）命名的字符串，也可以是文件路徑。

曾經困惑過，每個模塊都可以使用exports的情況下，為什么還必須用module.exports?

因為exports只是module.exports的一個地址引用，修改了exports的引用（如指向一個對象）就不能作為模塊導出。并且當module.exports已經具備一些屬性和方法時，Node 會忽略exports只導出module.exports。所以直接賦值給module.exports會更準確。

Node.js 借鑒了 CommonJS 規范的設計，特別是 CommonJS 的 Modules 規范，實現了一套模塊系統，同時 NPM 實現了 CommonJS 的 Packages 規范，模塊和包組成了 Node 應用開發的基礎。

上述模塊規范看起來十分簡單，只有module、exports和require，但 Node 是如何實現的呢？

需要經歷路徑分析（模塊的完整路徑）、文件定位（文件擴展名或目錄）、編譯執行三個步驟。

回顧require()接收 模塊標識 作為參數來引入模塊，Node 就是基于這個標識符進行路徑分析。不同的標識符采用的分析方式是不同的，主要分為一下幾類：

Node 提供的核心模塊，如 http、fs、path

核心模塊在 Node 源碼編譯時存為二進制執行文件，在 Node 啟動時直接加載到內存中，路徑分析中優先判斷，所以加載速度很快，而且也不用后續的文件定位和編譯執行。

如果想加載與核心模塊同名的自定義模塊，如自定義 http 模塊，那必須選用不同標志符或改用路徑方式。

路徑形式的文件模塊，.、..相對路徑模塊和/絕對路徑模塊

以.、..或/開始的標識符都會當成文件模塊處理，Node 會將require()中的路徑轉為真實路徑作為索引，然后編譯執行。

由于文件模塊明確了文件位置，所以縮短了路徑分析時間，加載速度僅慢與核心模塊。

自定義模塊，即非路徑形式的文件模塊

即不是核心模塊，也不是路徑形式的文件模塊，自定義文件是特殊的文件模塊，在路徑查找時 Node 會逐級查找該模塊路徑中的路徑。
模塊路徑查找策略示例如下：

// paths.js
console.log(module.paths)

// Terminal
$ node paths.js
[ "/Users/tong/WebstormProjects/testNode/node_modules",
"/Users/tong/WebstormProjects/node_modules",
"/Users/tong/node_modules",
"/Users/node_modules",
"/node_modules" ]

從上述示例輸出的模塊路徑數組可以看出，模塊的查找時沿當前路徑向上逐級查找node_modules目錄，直到目標路徑為止，類似 JS 原型鏈或作用域鏈。路徑越深速度越慢，所以自定義模塊加載速度最慢。

緩存優先機制：Node 會對引入過的模塊進行緩存以提高性能，不同于瀏覽器緩存的是文件，Node 緩存的是編譯和執行后的對象，所以require()對相同模塊的二次加載采用緩存優先的方式。這個緩存優先是第一優先級的，比核心模塊的優先級要高！

模塊路徑分析完成后是文件定位，主要包括文件擴展名的分析、目錄和包的處理。為了表達的更清晰，將文件定位分為四個步驟：

step1: 補充擴展名

通常require()中的標識符是不包含文件擴展名的，這種情況下，Node會按照 .js、.json、.node 的順序嘗試補充擴展名。

在嘗試補充擴展名時，需要調用 fs 模塊同步阻塞式判斷文件是否存在，所以這里提升性能的小技巧，就是 .json 和 .node 文件傳遞給require()時帶上擴展名會加快一些速度。

step2: 目錄處理查找 pakage.json

如果補充擴展名后沒有找到對應文件，但是得到了一個目錄，此時 Node會將目錄當做一個包處理。依據 CommonJS 包規范的實現，Node 會在目錄下查找pakage.json（包描述文件），通過JSON.parse()解析成包描述對象，從中取main屬性指定的文件名定位。

step3: 繼續默認查找 index 文件

如果沒有pakage.json或者main屬性指定的文件名錯誤，那 Node 會將 index 當做默認文件名，依次查找 index.js、index.json、index.node

step4: 進入下一個模塊路徑

在上述目錄分析過程中沒有成功定位時，自定義模塊按路徑查找策略進入上一層node_modules目錄，當整個模塊路徑數組遍歷完畢后沒有定位到文件，則會拋出查找失敗異常。

緩存加載的優化策略使得二次引入不需要路徑分析、文件定位、編譯執行這些過程，而且核心模塊也不需要文件定位的過程，這大大提高了再次加載模塊時的效率

Node 中每個模塊都是一個對象，在具體定位到文件后，Node 會新建該模塊對象，然后根據路徑載入并編譯。不同的文件擴展名載入方法為：

.js 文件: 通過 fs 模塊同步讀取后編譯執行

.json 文件: 通過 fs 模塊同步讀取后，用JSON.parse()解析并返回結果

.node 文件: 這是用 C/C++ 寫的擴展文件，通過process.dlopen()方法加載最后編譯生成的

其他擴展名: 都被當做 js 文件載入

載入成功后 Node 會調用具體的編譯方式將文件執行后返回給調用者。對于 .json 文件的編譯最簡單，JSON.parse()解析得到對象后直接賦值給模塊對象的exports，而 .node 文件是C/C++編譯生成的，Node 直接調用process.dlopen()載入執行就可以，下面重點介紹 .js 文件的編譯：

在 CommonJS 模塊規范中有module、exports 和 require 這3個變量，在 Node API 文檔中每個模塊還有 __filename、__dirname這兩個變量，但是在模塊中沒有定義這些變量，那它們是怎么產生的呢？

事實上在編譯過程中，Node 對每個 JS 文件都被進行了封裝，每個文件都是一個模塊，有自己的作用域。例如一個 JS 文件會被封裝成如下：

(function (exports, require, module, __filename, __dirname) {
    var math = require("math")
    export.add = function(){ //... }
})

首先每個模塊文件之間都進行了作用域隔離，通過vm原生模塊的runInThisContext()方法（類似 eval）返回一個具體的 function 對象，最后將當前模塊對象的exports屬性、require()方法、模塊對象本身module、文件定位時得到的完整路徑__filename和文件目錄__dirname作為參數傳遞給這個 function 執行。模塊的exports屬性上的任何方法和屬性都可以被外部調用，其余的則不可被調用。

至此，module、exports 和 require的流程就介紹完了。

編譯成功的模塊會將文件路徑作為索引緩存在 Module._cache 對象上，路徑分析時優先查找緩存，提高二次引入的性能。

總結來說 Node 模塊分為Node提供的核心模塊和用戶編寫的文件模塊。文件模塊是在運行時動態加載，包括了上述完整的路徑分析、文件定位、編譯執行這些過程，核心模塊在Node源碼編譯成可執行文件時存為二進制文件，直接加載在內存中，所以不用文件定位和編譯執行。

核心模塊分為 C/C++ 編寫的和 JavaScript 編寫的兩部分，在編譯所有 C/C++ 文件之前，編譯程序需要將所有的 JavaScript 核心模塊編譯為 C/C++ 可執行代碼，編譯成功的則放在 NativeModule._cache對象上，顯然和文件模塊 Module._cache的緩存位置不同。

在核心模塊中，有些模塊由純 C/C++ 編寫的內建模塊，主要提供 API 給 JavaScript 核心模塊，通常不能被用戶直接調用，而有些模塊由 C/C++ 完成核心部分，而 JavaScript 實現封裝和向外導出，如 buffer、fs、os 等。

所以在Node的模塊類型中存在依賴層級關系：內建模塊（C/C++）—> 核心模塊（JavaScript）—> 文件模塊。

使用require()十分的方便，但從 JavaScript 到 C/C++ 的過程十分復雜，總結來說需要經歷 C/C++ 層面內建模塊的定義、（JavaScript）核心模塊的定義和引入以及（JavaScript）文件模塊的引入。

對比前后端的 JavaScript，瀏覽器端的 JavaScript 需要經歷從同一個服務器端分發到多個客戶端執行，通過網絡加載代碼，瓶頸在于寬帶；而服務器端 JavaScript 相同代碼需要多次執行，通過磁盤加載，瓶頸在于 CPU 和內存，所以前后端的 JavaScript 在 Http 兩端的職責完全不用。

Node 模塊的引入幾乎是同步的，而前端模塊如果同步引入，那腳本加載需要太長的時間，所以 CommonJS 為后端 JavaScript 制定的規范不適合前端。而后出現 AMD 和 CMD 用于前端應用場景。

AMD 即異步模塊定義（Asynchronous Module Definition）,模塊定義為：

define(id?, dependencies?, factory);

AMD 模塊需要用define明確定義一個模塊，其中模塊id與依賴dependencies是可選的，factory的內容就是實際代碼的內容。例如指定一些依賴到模塊中：

define(["dep1", "dep2"], function(){
    // module code
});

require.js 實現 AMD 規范的模塊化，感興趣的可以查看 require.js 的文檔。

CMD 模塊的定義更加簡單：

 define(factory);

定義的模塊同 Node 模塊一樣是隱式包裝，在依賴部分支持動態引入，例如：

 define(function(require, exports, module){
     // module code
 });

require、exports、module通過形參傳遞給模塊，需要依賴模塊時直接使用require()引入。

sea.js 實現 AMD 規范的模塊化，感興趣的可以查看 sea.js 的文檔。

推薦兩本 Node 的書籍：《Node.js 實戰》主要是使用示例，《深入淺出 Node.js》偏實現原理。

當然我的博客也會繼續總結更新，下一篇內容會是關于 CommonJS 包規范和 NPM 包管理的內容。