Node.js 的入門門檻其實比想像中低。從一個 hello world 開始,就能順便理解一件很多人卡住的基礎:require 的路徑到底怎麼寫才對。
Node.js 的模組大致分成兩類。核心模組被編譯成二進位碼內建在執行環境裡,引用時只要寫 require("http") 這樣的識別字即可,不需要任何路徑。檔案模組則是你自己或第三方寫的 .js 檔,必須用路徑指定。
建立 module/server.js:
var http = require("http");
function start() {
function onRequest(request, response) {
console.log("Request received");
response.writeHead(200, { "Content-Type": "text/plain" });
response.write("hello, world");
response.end();
}
http.createServer(onRequest).listen(8888);
}
exports.start = start;
http 是內建模組,start 則是自訂的匯出。exports.start = start 讓其他檔案可以取得這個函式——這就是 CommonJS 模組的標準寫法。
建立與 module 資料夾同層的 index.js:
var server = require("./module/server");
server.start();
在專案目錄執行 node index.js,然後開瀏覽器拜訪 https://localhost:8888,就會看到 hello, world,同時終端機裡也會印出 Request received。
相對路徑 — 當前目錄:./xxx/xxx.js 或省略副檔名 ./xxx/xxx
相對路徑 — 上層目錄:../xxx/xxx.js 或 ../xxx/xxx
絕對路徑:/xxx/xxx.js 或 /xxx/xxx
最關鍵的規則是:以 . 或 .. 開頭的才是相對路徑,否則一律視為模組名稱。也就是說 require("server") 會去 node_modules 找名叫 server 的套件,而不是載入當前目錄的 server.js。這是新手最常犯的錯誤,而它不會報「找不到檔案」,只會說 Cannot find module,容易誤導方向。
Node.js 解析路徑時會依序嘗試 .js、.json、.node 三種副檔名,所以通常可以省略。若要載入某資料夾,Node 會找該資料夾下的 index.js。至於套件安裝則用 npm,模組會放進 node_modules,此時直接 require("套件名") 即可,不需要路徑。
在較新的版本中,若專案使用 ES Module(package.json 設 type: module),則改用 import 語法,且相對路徑必須寫完整的副檔名,這與 CommonJS 的規則不同,切換時要留意。