Java OutputStreamWriter 與 BufferedWriter 緩衝機制深度解析

核心差異總覽

兩層緩衝架構解析

應用程式
    ↓ write(char[])
BufferedWriter (字元緩衝, 8KB chars)
    ↓ write(char[], offset, len) / flushBuffer()
OutputStreamWriter (無額外字元緩衝，直接編碼)
    ↓ write(byte[]) / flush()
StreamEncoder → ByteBuffer → Channel
    ↓
作業系統檔案系統緩衝 (Page Cache, 通常 4KB+)
    ↓
磁碟控制器緩衝
    ↓
物理磁碟

關鍵釐清

• OutputStreamWriter 無字元級緩衝：其 8KB 為位元組級編碼緩衝（StreamEncoder 內部），非字元緩衝
• BufferedWriter 提供字元級緩衝：批次累積字元，減少下游 write(char[]) 呼叫次數
• OS 檔案系統緩衝為第三層：與 Java 類別無關，所有檔案 I/O 皆經過此層

實務選擇指南

場景一：需指定編碼寫入檔案

// 正確：指定 UTF-8 編碼寫入
try (OutputStreamWriter osw = new OutputStreamWriter(
        new FileOutputStream("file.txt"), StandardCharsets.UTF_8);
     BufferedWriter bw = new BufferedWriter(osw)) {
    bw.write("中文內容");
    bw.newLine();
}

場景二：高頻小量寫入（日誌、CSV）

// 必須加 BufferedWriter，否則每次 write 觸發編碼+系統呼叫
try (BufferedWriter bw = new BufferedWriter(
        new OutputStreamWriter(new FileOutputStream("log.txt"), "UTF-8"), 
        64 * 1024)) { // 擴大緩衝至 64KB
    for (String line : lines) {
        bw.write(line);
        bw.newLine();
    }
}

場景三：Socket 通訊

• BufferedWriter 可控制封包大小（配合 flush()）
• OutputStreamWriter 適用於二進制協議混合字元流

常見誤區

1. 誤以為 OutputStreamWriter 有字元緩衝 → 實際上每次 write(char[]) 幾乎直接編碼並下發
2. 雙重包裝 BufferedWriter(BufferedWriter(...)) → 無意義，只增加記憶體複製
3. 忽略 flush() → BufferedWriter 緩衝區未滿時資料不會送出