以下是您提供的英文文本的繁體中文翻譯：

# Node.js - Streams：初學者的指南

你好，未來的 Node.js 巔峰大師！今天，我們將要深入 Node.js 最强大和最引人入胜的功能之一：Streams。別擔心你编程新手；我會一步步地引導你，就像我過去幾年來為無數學生所做的那樣。所以，拿起你喜歡的飲料，放鬆一下，讓我們一起踏上這個令人興奮的冒險！

## Streams 是什麼？

想像一下，你試圖將水從一個大水箱搬到另一個。你有兩個選擇：

1. 一次性攜帶整個水箱的水（這將非常沉重且不切實際）。
2. 使用管道一點一點地傳遞水。

在 Node.js 的世界中，streams 就像那根管道。它們讓你可以逐個處理和處理數據，而不需要將所有數據一次性加載到內存中。這在處理大量數據或你想在數據完全可用之前開始處理數據時尤其有用。

### 為什麼使用 Streams？

1. **內存效率**：Streams 以小塊數據處理，所以你不需要一次性將所有東西加載到內存中。
2. **時間效率**：當你獲得第一塊數據時，就可以開始處理數據，而不是等待所有數據都可用。
3. **可組合性**：你可以輕鬆地將 streams 串在一起，創建強大的數據處理管道。

讓我們看一個簡單的例子來更好地理解這一點：

```javascript
const fs = require('fs');

// 不使用 streams
fs.readFile('bigfile.txt', (err, data) => {
  if (err) throw err;
  console.log(data);
});

// 使用 streams
const readStream = fs.createReadStream('bigfile.txt');
readStream.on('data', (chunk) => {
  console.log(chunk);
});

在第一种方法中，我們一次性讀取整個文件。如果文件非常大，這可能會消耗大量內存。在第二种方法中，我們使用 stream 逐塊讀取文件，這樣做更加節省內存。

Streams 的類型

現在我們已經了解了 streams 是什麼，讓我們來探索 Node.js 中不同類型的 streams。這就像學習不同類型的管道 - 每種都為特定目的而設計！

1. 可讀 Streams

可讀 streams 是數據的源頭。它們讓你可以從源頭讀取數據，比如文件或 HTTP 請求。

以下是一個創建和使用可讀 stream 的例子：

const fs = require('fs');

const readStream = fs.createReadStream('example.txt', 'utf8');

readStream.on('data', (chunk) => {
  console.log('接收到的塊：', chunk);
});

readStream.on('end', () => {
  console.log('文件讀取完成');
});

在這個例子中，我們從名為 'example.txt' 的文件創建了一個可讀 stream。當 stream 讀取數據時，會發出 'data' 事件，當讀取完成時會發出 'end' 事件。

2. 可寫 Streams

可寫 streams 是數據的目的地。它們讓你可以將數據寫入目的地，比如文件或 HTTP 响應。

讓我們看看如何創建和使用可寫 stream：

const fs = require('fs');

const writeStream = fs.createWriteStream('output.txt');

writeStream.write('你好，');
writeStream.write('Streams！');
writeStream.end();

writeStream.on('finish', () => {
  console.log('文件寫入完成');
});

在這個例子中，我們創建了一個指向 'output.txt' 文件的可寫 stream。我們向 stream 寫入一些數據，然後結束它。當所有數據都被寫入後，會發出 'finish' 事件。

3. Duplex Streams

Duplex streams 既可以讀又可以寫。把它們想像成雙向管道，數據可以在兩個方向上流動。

一個很好的 Duplex stream 的例子是 TCP 套接字：

const net = require('net');

const server = net.createServer((socket) => {
  socket.write('歡迎來到我們的服務器！\n');

  socket.on('data', (data) => {
    console.log('接收到的：', data.toString());
    socket.write('你說：' + data);
  });
});

server.listen(3000, () => {
  console.log('服務器正在監聽端口 3000');
});

在這個例子中，socket 是一個 Duplex stream。我們可以向它寫入（向客戶發送數據）並且也可以從它讀取（從客戶接收數據）。

4. Transform Streams

Transform streams 是一種特殊的 Duplex stream，輸出是基於輸入計算的。它們就像魔法管道，可以改變通過它的水！

以下是一個將輸入文本轉換为大寫的 Transform stream 的例子：

const { Transform } = require('stream');

const upperCaseTransform = new Transform({
  transform(chunk, encoding, callback) {
    this.push(chunk.toString().toUpperCase());
    callback();
  }
});

process.stdin.pipe(upperCaseTransform).pipe(process.stdout);

在這個例子中，我們創建了一個將文本轉换为大寫的 Transform stream。然後我們將標準輸入通過這個 Transform stream 並將其輸出到標準輸出。嘗試運行這個腚本並輸入一些文本 - 你會看到它全部以大寫出現！

Stream 方法與事件

為了有效地使用 streams，關鍵是要理解它們的方法和事件。讓我們分開來看：

Stream 類型	常見方法	常見事件
可讀	pipe()、read()、pause()、resume()	data、end、error、close
可寫	write()、end()	drain、finish、error、close
Duplex	pipe()、read()、write()、end()	data、end、error、close、drain、finish
Transform	pipe()、read()、write()、end()	data、end、error、close、drain、finish

串接 Streams

Streams 最强大的功能之一就是能夠將它們串接在一起。這讓你可以輕鬆地創建复杂的数据处理管道。

以下是一个读取文件、压缩并写入新文件的例子：

const fs = require('fs');
const zlib = require('zlib');

const readStream = fs.createReadStream('input.txt');
const writeStream = fs.createWriteStream('output.txt.gz');
const gzip = zlib.createGzip();

readStream.pipe(gzip).pipe(writeStream);

writeStream.on('finish', () => {
  console.log('文件成功压缩');
});

在這個例子中，我們将可读 stream 通过一个 gzip Transform stream 串接到一个可写 stream。就像连接不同类型的管道以达到特定目标一样！

結論

恭喜你！你剛剛踏入了 Node.js streams 的奇妙世界。我們已經介紹了 streams 是什麼，它們為什麼有用，不同類型的 streams，以及如何使用它們。記住，streams 是你 Node.js 工具包中的强大工具，讓你可以高效地处理数据并创建可扩展的应用程序。

在你继续在 Node.js 的旅程中，你會發現 streams 到處都是 - 从文件操作到网络通信。不要害怕在你的项目中尝试使用它们。像任何技能一样，使用 streams 的过程会随着练习变得更加简单。

继续编码，继续学习，最重要的是，享受乐趣！誰知道呢？也許有一天，你會成為教導別人 Node.js streams 魔法的人。直到下次，快乐 streaming！

Credits: Image by storyset