JavaScript 誕生之初,幾乎沒人把它當成一門正經的程式語言。Web 1.0 時代,這個腳本語言主要用來做表單驗證與網頁特效;直到 Web 2.0,前端工程師靠它大幅提升了使用者體驗,JS 才真正被重視。在它逐步普及的過程中,大致走過工具類庫、元件庫、前端框架、前端應用這幾個階段。
JavaScript 天生缺了一塊拼圖:模組。CommonJS 規範的出現補上了這個缺口。
其他語言早有成熟方案:Java 有 class 檔案,Python 有 import,PHP 有 include 與 require,而 JS 只能靠 <script> 標籤引入,顯得雜亂無章。過去人們不得不用命名空間等方式人為約束程式碼,直到 CommonJS 出現,前後端的 JavaScript 才有了統一標準。Node 借鑑了 CommonJS 的 Modules 規範,實作了一套非常好用的模組系統,它由三部分組成:
1. 模組引用:以 require() 傳入模組標識,把目標模組的 API 引入當前上下文,例如 var math = require('math');
2. 模組定義:以 exports 物件導出當前模組的方法或變數。模組中還存在一個 module 物件,exports 其實是它的屬性。在 Node 中一個檔案就是一個模組,模組內的「全域變數」對外不可見,只有掛在 exports 上的屬性才是公開的,例如 exports.add = function() {}; exports.PI = 3.1415926;
3. 模組標識:即傳給 require() 的參數,必須是符合 camel 命名法的字串,或以「.」「..」開頭的相對/絕對路徑,副檔名「.js」可以省略
Node 的模組分兩類:一類是 Node 自帶的核心模組,其中一部分在編譯 Node 原始碼時就被編其二進位檔,Node 啟動時直接載入記憶體,因此載入最快;另一類是使用者撰寫的檔案模組,在執行時動態載入,需經歷路徑分析、檔案定位、編譯執行三個步驟。特別注意:Node 會快取已引入的模組,同一模組的二次載入優先走快取,以減少重複開銷。
主要分析傳入的模組標識,可分四類:
1. 核心模組,如 http、fs、path
2. 以 . 或 .. 開頭的相對路徑檔案模組
3. 以 / 開頭的絕對路徑檔案模組
4. 自訂檔案模組,可能是單一檔案或一個套件。Node 會依 module.paths 陣列逐個嘗試,通常是沿當前目錄逐層向上,直到根目錄去尋找名為 node_modules 的目錄——這是四類中最耗時的一種
1. 副檔名分析:由於規範允許省略副檔名,Node 會依 .js、.json、.node 的順序補齊並依次嘗試
2. 目錄分析與套件:若上述步驟找到的是一個目錄而非檔案,Node 會把它當成一個套件來處理
定位到具體檔案後,Node 會建立一個新的模組物件,依路徑載入並編譯。不同副檔名的載入方式不同:
1. .js:以 fs 模組同步讀取後編譯執行
2. .node:以 C/C++ 撰寫的擴充檔案,透過 dlopen() 載入
3. .json:以 fs 模組同步讀取,再用 JSON.parse() 解析
4. 其他副檔名:一律視為 .js 載入
那麼,為什麼每個模組裡預設都存在 require、exports、module,甚至還有 filename 與 dirname?Node 又是如何做到「全域變數」不污染其他模組的?答案在編譯階段:Node 會對檔案內容做頭尾包裝。
(function (exports, require, module, __filename, __dirname) {
/* 中間是 JS 檔案的實際內容 */
var math = require('math');
exports.area = function (radius) {
return Math.PI * radius * radius;
};
/* JS 檔案的實際內容結束 */
});
如此一來,每個模組之間就有了作用域隔離,同時 require、exports、module 等變數也被注入到模組上下文中——這正是 Node 對 CommonJS 模組規範的實作方式。(C/C++ 模組與核心模組的編譯過程較為複雜,此處不再展開。)

C/C++ 內建模組位於最底層,屬於核心模組,主要提供 API 給 JavaScript 核心模組與第三方檔案模組呼叫,實務中幾乎不會直接接觸。JavaScript 核心模組有兩種職責:一是作為 C/C++ 內建模組的封裝與橋接層供檔案模組使用,二是純粹的功能模組,不需與底層互動。檔案模組通常由第三方撰寫,包含普通 JS 模組與 C/C++ 擴充模組。
套件本質上是一個存檔檔(一般為 .zip 或 .tar.gz),安裝時解壓還原成目錄。CommonJS 的套件規範由套件結構與套件描述檔兩部分組成,一個完全合規的結構應包含:
1. package.json:套件描述檔
2. bin:存放可執行二進位檔的目錄
3. lib:存放 JavaScript 程式碼的目錄
4. doc:存放文件的目錄
5. test:存放單元測試的目錄
package.json 位於套件根目錄,是極重要的組成部分,NPM 的幾乎所有行為都與它的欄位相關。以 express 專案為例,常用欄位包括:
1. name:套件名稱
2. description:套件簡介
3. version:版本號,需遵循「語意化版本控制」(參照 semver.org)
4. dependencies:執行時所需相依套件清單,NPM 會依此自動載入相依套件,重要性最高
5. repositories:原始碼託管位置清單
NPM(Node Package Manager)主要負責 Node 套件的安裝、移除、更新、查詢、搜尋與發布。
安裝方式分兩種:本地安裝 npm install <package-name> 會把套件下載到當前目錄,僅能在該目錄使用;全域安裝 npm install -g <package-name> 會裝到系統特定目錄,可在任何位置使用。
以 grunt-cli 為例的常用套件管理指令:
npm install // 安裝 package.json 中 dependencies 與 devDependencies 宣告的所有套件 npm install grunt-cli@0.1.9 // 安裝指定版本 npm install grunt-contrib-copy --save // 安裝並把相依寫回 package.json npm uninstall grunt-cli // 移除套件 npm list // 查看已安裝的套件 npm publish <folder> // 發布套件