Node系列 · Node基礎(chǔ)基礎(chǔ)內(nèi)置模塊Node 內(nèi)置的核心模塊里os/path/url/util是幾乎每個項目都會用的四件套。它們不依賴任何第三方包跨平臺行為一致理解它們的真實行為能避免一類經(jīng)典的在我電腦能跑問題。一、os與操作系統(tǒng)交互os模塊提供操作系統(tǒng)層面的查詢能力——CPU、內(nèi)存、用戶目錄、網(wǎng)絡(luò)接口等。常用 APIAPI返回類型用途os.EOLstring當(dāng)前系統(tǒng)的行結(jié)束符\n/\r\nos.arch()stringCPU 架構(gòu)arm64/x64os.cpus()array每顆邏輯 CPU 核心信息os.freemem()number空閑內(nèi)存字節(jié)數(shù)os.totalmem()number總內(nèi)存字節(jié)數(shù)os.homedir()string當(dāng)前用戶目錄os.hostname()string主機名os.tmpdir()string系統(tǒng)臨時目錄os.platform()string平臺標(biāo)識darwin/linux/win32os.uptime()number系統(tǒng)啟動到現(xiàn)在的秒數(shù)os.networkInterfaces()object網(wǎng)絡(luò)接口列表典型應(yīng)用// 根據(jù) CPU 核心數(shù)決定要不要起 worker const cpuCount os.cpus().length; const workers Math.max(1, cpuCount - 1); // 把日志寫到系統(tǒng)臨時目錄 const logDir path.join(os.tmpdir(), my-app-logs); fs.mkdirSync(logDir, { recursive: true });::: warning不要拿os.cpus().length當(dāng)真實物理核心數(shù)。它返回的是邏輯核心數(shù)含超線程。Node 單進(jìn)程只能用一個 CPU 核心物理多核需要 Worker Threads 或多進(jìn)程。:::二、path跨平臺路徑處理path模塊的核心價值是屏蔽 Windows / POSIX 路徑差異。Node 代碼里永遠(yuǎn)不要直接拼字符串路徑全部走pathAPI。2.1 核心 APIAPI作用示例path.basename(p)取文件名path.basename(/a/b/c.txt)→c.txtpath.dirname(p)取目錄path.dirname(/a/b/c.txt)→/a/bpath.extname(p)取后綴path.extname(/a/b/c.txt)→.txtpath.join(...p)拼接多段路徑path.join(/a, b, c.txt)→/a/b/c.txtpath.resolve(...p)解析為絕對路徑path.resolve(c.txt)→cwd/c.txtpath.relative(from, to)計算相對路徑path.relative(/a/b, /a/c/d)→../c/dpath.isAbsolute(p)是否絕對路徑path.isAbsolute(/a)→truepath.normalize(p)規(guī)范化路徑path.normalize(/a//b/./c)→/a/b/cpath.sep當(dāng)前系統(tǒng)的路徑分隔符Linux\\(實際 /) / Windows\path.delimiter環(huán)境變量分隔符Linux:/ Windows;2.2joinvsresolve兩個看著像行為差異很大// join純拼接結(jié)果是不是絕對路徑看輸入 path.join(/a, b, c.txt); // /a/b/c.txt path.join(a, b, c.txt); // a/b/c.txt // resolve從右往左拼遇到絕對路徑就重置起點 path.resolve(a, b, c.txt); // cwd/a/b/c.txt path.resolve(/a, b, /c.txt); // /c.txt遇到 /c.txt 重置2.3 跨平臺注意事項// ? 錯誤直接拼字符串 const filePath __dirname /config/ filename; // ? 正確用 path.join const filePath path.join(__dirname, config, filename); // ? 錯誤硬編碼分隔符 const tmpPath /tmp/ name; // ? 正確用 os.tmpdir() path.join const tmpPath path.join(os.tmpdir(), name);三、urlURL 解析與構(gòu)造url模塊提供 WHATWG URL 標(biāo)準(zhǔn)實現(xiàn)Node 10。3.1 核心 APIAPI用途new URL(input, base?)構(gòu)造一個 URL 對象URLSearchParamsURL 查詢字符串解析url.fileURLToPath(url)file://URL → 路徑url.pathToFileURL(path)路徑 →file://URL3.2 URL 對象const u new URL(https://user:passexample.com:8080/path/to?x1y2#hash); u.protocol; // https: u.host; // example.com:8080 u.hostname; // example.com u.port; // 8080 u.pathname; // /path/to u.search; // ?x1y2 u.hash; // #hash u.username; // user u.password; // pass u.origin; // https://example.com:80803.3 查詢參數(shù)const u new URL(https://example.com/api?x1y2); // 讀取 u.searchParams.get(x); // 1 u.searchParams.getAll(x); // [1] u.searchParams.has(z); // false // 增刪改 u.searchParams.append(z, 3); u.searchParams.set(x, 10); u.searchParams.delete(y); // 序列化 u.toString(); // https://example.com/api?x10z3 // 單獨構(gòu)造 const params new URLSearchParams({ foo: 1, bar: 2 }); params.toString(); // foo1bar23.4 路徑與 URL 互轉(zhuǎn)import { fileURLToPath, pathToFileURL } from node:url; // path → file:// URL pathToFileURL(/usr/local/bin); // file:///usr/local/bin // file:// URL → path fileURLToPath(file:///usr/local/bin); // /usr/local/binESM 模塊下import.meta.url是file://URL要拿路徑必須fileURLToPath轉(zhuǎn)一次CJS 下直接是__dirname。四、util工具函數(shù)集合util模塊聚集了各種雜項但有用的工具。4.1 類型判斷util.isArray([]); // true util.isDate(new Date()); // true util.isRegExp(/x/); // true util.types.isPromise(Promise.resolve()); // true util.types.isMap(new Map()); // true util.types.isSet(new Set()); // true util.types.isArrayBuffer(new ArrayBuffer(8)); // true::: tipNode 10 之后Array.isArray/instanceof已經(jīng)夠用util.isArray等被視為遺留 API。新代碼建議用util.types或原生Array.isArray。:::4.2 回調(diào)與 Promise 互轉(zhuǎn)// 舊的 CJS 回調(diào)風(fēng)格 API(err, value) {...} // 想用 async/awaitutil.promisify 把它包成返回 Promise 的函數(shù) const fs require(fs); const readFile util.promisify(fs.readFile); const data await readFile(./config.json, utf-8); // 反向Promise 風(fēng)格 API 想給老代碼用util.callbackify const asyncAdd async (a, b) a b; const cbAdd util.callbackify(asyncAdd); cbAdd(1, 2, (err, sum) { console.log(sum); // 3 });4.3 繼承inherits// ES6 class 時代幾乎不用——直接用 extends 即可 // 留給老代碼理解 function Animal() {} Animal.prototype.greet function () { return hello; }; function Dog() {} util.inherits(Dog, Animal); Dog.prototype.bark function () { return woof; }; const d new Dog(); d.greet(); // hello d.bark(); // woof4.4 深度嚴(yán)格比較util.isDeepStrictEqual( { a: 1, b: [1, 2] }, { a: 1, b: [1, 2] } ); // true // 與 的關(guān)鍵區(qū)別遞歸比較對象、數(shù)組、Map、Set 1 1; // true { a: 1 } { a: 1 }; // false util.isDeepStrictEqual( { a: 1 }, { a: 1 } ); // true4.5 調(diào)試輸出const obj { a: 1, b: { c: [1, 2, 3] } }; console.log(util.inspect(obj, { depth: 4, colors: true }));util.inspect是console.log內(nèi)部實現(xiàn)可以指定深度、顏色、隱藏字段等。調(diào)試復(fù)雜對象時比直接JSON.stringify信息更全保留函數(shù)、undefined、循環(huán)引用。五、其他常用內(nèi)置模塊速覽模塊用途備注querystringURL 查詢字符串URLSearchParams已覆蓋大部分場景assert斷言單元測試Node 自帶測試時用jest 流行后少用eventsEventEmitter見第 12 章stream流處理見第 7 章crypto加密 / hash見后續(xù)章節(jié)zlib壓縮 / 解壓gzip / deflatechild_process子進(jìn)程spawn / exec / fork六、最佳實踐場景推薦做法反例拼接文件路徑path.join/path.resolve字符串拼讀用戶目錄os.homedir()假設(shè)是/home/x寫臨時文件os.tmpdir()path.join假設(shè)是/tmp解析 URLnew URL(...)searchParams手寫 split老 API 轉(zhuǎn) Promiseutil.promisify自己手寫 wrapper判斷內(nèi)置類型util.typesinstanceof跨 realm 不可靠多行字符串拼接path.join或os.EOL硬編碼\n/\r\n七、小結(jié)os提供系統(tǒng)信息查詢os.cpus().length是邏輯核心數(shù)含超線程path是跨平臺路徑處理的唯一正確選擇join拼接、resolve解析為絕對路徑url用 WHATWG 標(biāo)準(zhǔn)new URLsearchParams處理查詢參數(shù)util.promisify把回調(diào) API 包成 Promiseutil.callbackify反向這些模塊零依賴——新項目能少裝一個包就少裝一個