Node.js 是一套用來打造高效能網路服務的 JavaScript 工具包,它的一個鮮明特徵是假設你運行在 POSIX 環境(Linux 或 Mac OS X)下——這在早期的檔案路徑處理上確實造成過一些困擾。
讀檔是最基本的操作之一。最精簡的同步寫法如下:
var fs = require('fs');
var file = fs.readFileSync(path, "utf8");
console.log(file);
加上編碼參數 "utf8" 之後,readFileSync 直接回傳字串;若省略,回傳的是 Buffer。
同一件事有三種寫法,適用場景各異。
非同步回呼——不阻塞事件迴圈,是伺服器端的正解:
const fs = require('fs');
fs.readFile(path, 'utf8', function (err, data) {
if (err) { console.error(err); return; }
console.log(data);
});
同步——程式碼最直白,但會阻塞整個行程。只適合用在啟動時讀設定檔、CLI 小工具這類一次性場景,Web 服務中請勿使用。
Promise/async——兼顧可讀性與非阻塞,現代的預設選擇:
const fs = require('fs/promises');
async function main() {
try {
const data = await fs.readFile(path, 'utf8');
console.log(data);
} catch (err) {
console.error(err);
}
}
一定要指定編碼。不指定就得到 Buffer,後續當字串用會出現意料之外的行為。
錯誤處理不能省。檔案不存在、權限不足、路徑是目錄——這些都會透過 err 參數回來,忽略它只會讓問題延後爆發。
大檔案請用串流。一次讀進記憶體在檔案很大時會 OOM,改用 createReadStream 逐段處理:
const { createReadStream } = require('fs');
const readline = require('readline');
const rl = readline.createInterface({
input: createReadStream(path, 'utf8'),
crlfDelay: Infinity
});
for await (const line of rl) {
console.log(line);
}
路徑請用 path 模組組。直接的字串拼接在 Windows 上會因為反斜線而失效,path.join(__dirname, 'data', 'a.json') 才是可攜的做法。
讀 JSON 的話還有更短的寫法:require('./data.json') 會自動解析並快取,但快取行為在需要讀取最新內容時反而是障礙;fs.readFile 搭配 JSON.parse 在這種情境下更合適。