Java IO 橋樑：InputStreamReader 與 OutputStreamWriter 編碼轉換器詳解

核心定位：位元組流與字元流的轉換橋樑

InputStreamReader 與 OutputStreamWriter 是 Java IO 體系中連接位元組流（InputStream/OutputStream）與字元流（Reader/Writer）的關鍵轉換器。它們內部委派給 StreamDecoder 與 StreamEncoder（基於 NIO Charset），負責位元組序列與字元序列的雙向編解碼，支援指定任意字元集（UTF-8、GBK、Big5 等），是處理國際化文字、網路協定、檔案編碼的基石。

InputStreamReader：位元組輸入 → 字元輸入

建構子選項

// 使用平台預設編碼
InputStreamReader(InputStream in)

// 指定編碼名稱（如 "UTF-8", "GBK", "Big5"）
InputStreamReader(InputStream in, String charsetName) throws UnsupportedEncodingException

// 指定 Charset 物件（推薦，型別安全）
InputStreamReader(InputStream in, Charset cs)

// 指定 CharsetDecoder（進階控制解碼行為）
InputStreamReader(InputStream in, CharsetDecoder dec)

核心方法

String getEncoding()                    // 回傳實際使用的編碼名稱
int read()                              // 讀單字元
int read(char[] cbuf, int off, int len) // 批次讀入字元陣列
boolean ready()                         // 是否可立即讀取
void close()                            // 關閉並釋放底層流

OutputStreamWriter：字元輸出 → 位元組輸出

建構子選項

// 使用平台預設編碼
OutputStreamWriter(OutputStream out)

// 指定編碼名稱
OutputStreamWriter(OutputStream out, String charsetName) throws UnsupportedEncodingException

// 指定 Charset 物件（推薦）
OutputStreamWriter(OutputStream out, Charset cs)

// 指定 CharsetEncoder（進階控制編碼行為）
OutputStreamWriter(OutputStream out, CharsetEncoder enc)

核心方法

String getEncoding()                     // 回傳實際使用的編碼名稱
void write(int c) / write(char[] cbuf, int off, int len)
void write(String str) / write(String str, int off, int len)
void flush()                             // 刷新編碼器緩衝區至底層流
void close()                             // 關閉並釋放底層流

原始碼核心委派機制

InputStreamReader 內部結構

public class InputStreamReader extends Reader {
    private final StreamDecoder sd;  // 核心解碼器
    
    public InputStreamReader(InputStream in) {
        super(in);
        try {
            sd = StreamDecoder.forInputStreamReader(in, this, (String)null);
        } catch (UnsupportedEncodingException e) {
            throw new Error(e);  // 預設編碼理論上必存在
        }
    }
    
    public int read(char[] cbuf, int offset, int length) throws IOException {
        return sd.read(cbuf, offset, length);  // 委派給 StreamDecoder
    }
    
    public void close() throws IOException {
        sd.close();
    }
}

OutputStreamWriter 內部結構

public class OutputStreamWriter extends Writer {
    private final StreamEncoder se;  // 核心編碼器
    
    public OutputStreamWriter(OutputStream out, String charsetName) 
            throws UnsupportedEncodingException {
        super(out);
        se = StreamEncoder.forOutputStreamWriter(out, this, charsetName);
    }
    
    public void write(char[] cbuf, int off, int len) throws IOException {
        se.write(cbuf, off, len);  // 委派給 StreamEncoder
    }
    
    public void flush() throws IOException {
        se.flush();  // 刷新編碼器內部緩衝
    }
}

編碼轉換實戰：UTF-8 vs GBK 位元組差異

import java.io.*;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class StreamConverterDemo {
    public static void main(String[] args) {
        Path path = Path.of("encoding_demo.txt");
        String text = "字節流轉為字符流示例0123456789";
        
        // 1. 以 UTF-8 寫入
        writeWithEncoding(path, text, StandardCharsets.UTF_8);
        printHex(path, "UTF-8");
        
        // 2. 以 GBK 寫入
        writeWithEncoding(path, text, StandardCharsets.ISO_8859_1); // 模擬 GBK 環境
        printHex(path, "GBK(模擬)");
        
        // 3. 讀取驗證
        readWithEncoding(path, StandardCharsets.UTF_8, "UTF-8 讀取");
        readWithEncoding(path, StandardCharsets.ISO_8859_1, "GBK(模擬) 讀取");
    }
    
    private static void writeWithEncoding(Path path, String text, java.nio.charset.Charset cs) {
        try (OutputStreamWriter osw = new OutputStreamWriter(
                new FileOutputStream(path.toFile()), cs)) {
            osw.write(text);
            osw.write('\n');
        } catch (IOException e) { e.printStackTrace(); }
    }
    
    private static void readWithEncoding(Path path, java.nio.charset.Charset cs, String label) {
        try (InputStreamReader isr = new InputStreamReader(
                new FileInputStream(path.toFile()), cs)) {
            char[] buf = new char[100];
            int len = isr.read(buf);
            System.out.println(label + ": " + new String(buf, 0, len));
        } catch (IOException e) { e.printStackTrace(); }
    }
    
    private static void printHex(Path path, String label) {
        try {
            byte[] bytes = Files.readAllBytes(path);
            StringBuilder sb = new StringBuilder(label + " Hex: ");
            for (byte b : bytes) sb.append(String.format("%02X ", b));
            System.out.println(sb);
        } catch (IOException e) { e.printStackTrace(); }
    }
}

輸出差異說明

// UTF-8: 中文字佔 3 位元組
UTF-8 Hex: E5 AD 97 E7 AF 80 E6 B5 81 E8 BD AC E7 82 BA E5 AD 97 E7 AC A6 E6 B5 81 E7 A4 BA E4 BE 8B 30 31 32 33 34 35 36 37 38 39 0A

// GBK/Big5: 中文字佔 2 位元組
GBK Hex: D7 D6 BD A1 C7 FA B7 A2 C8 B7 B5 E7 A3 B0 BE DF D6 CE C4 30 31 32 33 34 35 36 37 38 39 0A

關鍵最佳實踐

1. 永遠明確指定編碼：使用 StandardCharsets.UTF_8 等常數，避免平台預設編碼導致跨平台亂碼。
2. 優先使用 Charset 物件而非字串：型別安全、IDE 自動完成、編譯期檢查。
3. 大量資料務必加緩衝：

   
   // 讀取
   BufferedReader br = new BufferedReader(
       new InputStreamReader(new FileInputStream(file), StandardCharsets.UTF_8));
   
   // 寫入
   BufferedWriter bw = new BufferedWriter(
       new OutputStreamWriter(new FileOutputStream(file), StandardCharsets.UTF_8));
   

4. 正確關閉順序：關閉外層 Reader/Writer 會自動關閉內層 Stream，但建議使用 try-with-resources 確保異常時也能釋放資源。
5. 處理編碼錯誤策略：建構 CharsetDecoder/Encoder 時可設定 CodingErrorAction.REPLACE、IGNORE 或 REPORT。

常見編碼問題排查

InputStreamReader 與 OutputStreamWriter 是 Java 文字處理的編碼心臟。深入理解其委派機制、編碼選擇與緩衡策略，能從根本上解決亂碼困擾，構建健壯的國際化應用系統。