Node.js 的模組大致可分為核心模組與檔案模組兩類。
核心模組被編譯成二進位碼,引用時只需給識別字即可,例如 require('net')、require('fs')。
檔案模組則是 js、json 或 .node 檔。引用時必須帶上路徑:
/.../.../xxx.js 表示絕對路徑;./xxx.js 表示同目錄下的相對路徑;../ 表示上一層目錄。若三種前綴都不加,Node 會把該名稱當成核心模組,或前往 node_modules 目錄搜尋。
當 require 的參數沒有 ./、../ 或 / 前綴時,Node 會由目前檔案所在目錄開始,逐層往上尋找 node_modules。例如 /home/ry/projects/foo.js 中呼叫 require('bar.js'),搜尋順序為:
/home/ry/projects/node_modules/bar.js /home/ry/node_modules/bar.js /home/node_modules/bar.js /node_modules/bar.js
整個資料夾也可以當成一個模組。做法是在資料夾根層建立 package.json 來標示主模組:
{
"name": "some-library",
"main": "./lib/some-library.js"
}
若這份 package.json 位於 ./some-library 下,那麼 require('./some-library') 會嘗試載入 ./some-library/lib/some-library.js。
如果該目錄中沒有 package.json,Node 會退回尋找該目錄下的 index.js 或 index.node:
./some-library/index.js ./some-library/index.node
理解這套解析規則很有實際價值:它解釋了為什麼有時 require 會「找不到模組」(往往是被上層某個 node_modules 搶先命中),也說明了為什麼套件都安裝在專案根目錄的 node_modules 中最容易被子目錄正確引用。