Node.js中的process.stdout.write和console.log都是用于向標準輸出流(stdout)打印輸出的方法，但二者在使用場景和實現方式上有些區別。本文將詳細介紹process.stdout.write和console.log的區別。

process.stdout.write介紹

process.stdout.write是Node.js中的一個核心API,用于向標準輸出流(stdout)寫入數據。

它的主要特點包括:

• 用于向終端打印輸出。node中的console.log方法內部就是使用process.stdout.write實現的。
• 可以寫入Buffer對象或字符串。
• 寫入是異步的，需要通過注冊'drain'事件來知道流是否為空并等待寫入完成。
• 如果stdout傳給了管道(pipe)，寫入會阻塞直到輸出消費者讀取數據。
• 默認情況下stdout是塊緩沖的，調用process.stdout.write()并不會總是立即打印到終端，需要設置{ stdio: 'ignore' }來禁用緩沖。

它的函數簽名是:

process.stdout.write(chunk[, encoding][, callback])

參數說明:

• chunk：要寫入的數據，可以是Buffer對象或字符串
• encoding：如果寫入的是字符串，該參數指定字符編碼，默認為'utf8'
• callback：回調函數，在數據寫入完成后被調用

使用示例：

process.stdout.write('Hello '); 
process.stdout.write('World!' + '\n');

// 注冊'drain'事件以知道流是否為空
process.stdout.on('drain', () => {
  console.log('write completed, stdout drained');
});

process.stdout.write直接寫入的都是原始數據流，支持寫入Buffer對象和字符串。它通過系統級的文件描述符來實現對標準輸出流的操作。

console.log介紹

console.log也是用于向標準輸出打印數據，是Node.js CONSOLE模塊提供的方法。

它的函數簽名是:

console.log([data][, ...args])

參數說明:

• data：要輸出的內容，可以是多個，會依次打印
• args：其它要替換輸出的內容

console.log接受的參數非常靈活，可以輸出多個內容，并且支持字符串替換和格式化。

區別比較

1、使用場景不同

process.stdout.write是底層的API，允許對stdout流進行更底層的控制。適用于需要自己控制寫入timing的場景，比如繪制終端進度條、動畫等。

console.log是更高級的打印方法,默認情況下會添加換行，輸出內容比較人性化，適用于日常的debug打印。

2、實現機制不同

process.stdout.write是直接系統調用，通過文件描述符對標準流進行寫操作。

console.log需要輸出的內容會先被Console類處理格式化后，再通過系統的process.stdout.write進行底層寫操作。

3、輸出內容不同

process.stdout.write直接寫入的是Buffer對象或字符串的數據。

console.log支持多參數輸入，可以輸出復雜的嵌套數據，并且會自動申請內存空間，不需要自己創建Buffer。

4、緩沖機制不同

process.stdout.write的寫入是同步的，調用一次就會立即執行寫入。

console.log默認是行緩沖的,即輸出內容不會立即打印到終端，會進行緩沖，在遇到換行或主動flush的時候才輸出。

5、編碼處理不同

process.stdout.write支持手動指定編碼，如'utf8'等。

console.log會自動判斷編碼，在處理多字節字符集時更友好。

6、補充換行不同

process.stdout.write不會添加任何換行或空格。

console.log默認打印內容后會補充一個換行符'\n'。

7、異步機制不同

process.stdout.write支持回調函數通知寫入完成。

console.log沒有回調，寫入同步進行。

何時使用process.stdout.write

由于process.stdout.write更底層，所以什么時候會需要用到它呢?

主要的使用場景包括:

• 需要按特定頻率輸出內容，比如打印下載進度
• 需要對終端進行更細粒度控制，例如清除行、光標位置等
• 生成輸出圖表或動畫效果
• 實現日志記錄系統，需要精確寫入時間而不是緩沖輸出
• 需要與管道或其他類型的流集成時，用更底層的寫操作會更方便

總結

process.stdout.write和console.log作為Node.js中打印輸出的兩種主要方式，各有優勢：

• process.stdout.write提供底層的寫操作控制，支持流動態寫入，但需要自己管理緩沖和編碼處理。
• console.log提供了更方便的格式化輸出，自動管理緩沖，支持復雜數據打印，非常適合日常debug使用。

明確兩者的區別和適用場景，可以根據具體需求選擇更合適的打印輸出方式。