设置PrintStream为UTF-8仍无法打印Unicode字符问题求助

问题描述 #

在logClass中将控制台输出重定向到JTextPane时，无法正确打印变音符号“üäß”。已在Console方法中设置PrintStream使用UTF-8编码，也尝试过更换字体，但特殊字符始终显示错误。

原代码 #

private JPanel logPanel;
private JScrollPane logScrollPanel;
private JTextPane textArea;
private Thread stdOutReader;
private Thread stdErrReader;
private boolean stopThreads;
private final PipedInputStream stdOutPin = new PipedInputStream();
private final PipedInputStream stdErrPin = new PipedInputStream();
private StyledDocument doc;
private Style style;

public void Console() {
    doc = (StyledDocument) textArea.getDocument();
    style = doc.addStyle("ConsoleStyle", null);
    StyleConstants.setFontFamily(style, "MonoSpaced");
    StyleConstants.setFontSize(style, 12);

    try {
        PipedOutputStream stdOutPos = new PipedOutputStream(this.stdOutPin);
        System.setOut(new PrintStream(stdOutPos, true, "UTF-8"));
    } catch (java.io.IOException io) {
        textArea.setText("Couldn't redirect STDOUT to this console\n" + io.getMessage());
    } catch (SecurityException se) {
        textArea.setText("Couldn't redirect STDOUT to this console\n" + se.getMessage());
    }

    try {
        PipedOutputStream stdErrPos = new PipedOutputStream(this.stdErrPin);
        System.setErr(new PrintStream(stdErrPos, true, "UTF-8"));
    } catch (java.io.IOException io) {
        textArea.setText("Couldn't redirect STDERR to this console\n" + io.getMessage());
    } catch (SecurityException se) {
        textArea.setText("Couldn't redirect STDERR to this console\n" + se.getMessage());
    }

    stopThreads = false; 
    stdOutReader = new Thread(this);
    stdOutReader.setDaemon(true);
    stdOutReader.start();

    stdErrReader = new Thread(this);
    stdErrReader.setDaemon(true);
    stdErrReader.start();
}

public synchronized void run() {
    try {
        while (Thread.currentThread() == stdOutReader) {
            try {
                this.wait(100);
            } catch (InterruptedException ie) {
            }
            if (stdOutPin.available() != 0) {
                String input = this.readLine(stdOutPin);
                StyleConstants.setForeground(style, Color.black);
                doc.insertString(doc.getLength(), input, style);
                textArea.setCaretPosition(textArea.getDocument().getLength());
            }
            if (stopThreads) {
                return;
            }
        }

        while (Thread.currentThread() == stdErrReader) {
            try {
                this.wait(100);
            } catch (InterruptedException ie) {
            }
            if (stdErrPin.available() != 0) {
                String input = this.readLine(stdErrPin);
                StyleConstants.setForeground(style, Color.red);
                doc.insertString(doc.getLength(), input, style);
                textArea.setCaretPosition(textArea.getDocument().getLength());
            }
            if (stopThreads) {
                return;
            }
        }
    } catch (Exception e) {
        textArea.setText("\nConsole reports an Internal error.");
        textArea.setText("The error is: " + e);
    }
}

private synchronized String readLine(PipedInputStream in) throws IOException {
    String input = "";
    do {
        int available = in.available();
        if (available == 0) {
            break;
        }
        byte b[] = new byte[available];
        in.read(b);
        input += new String(b, 0, b.length);
    } while (!input.endsWith("\n") && !input.endsWith("\r\n") && !stopThreads);
    return input;
}

解决方案 #

1. 修复字节转字符串的编码指定 #

原代码中new String(b, 0, b.length)未指定编码，会使用系统默认编码解码UTF-8字节流，导致乱码。修改为明确指定UTF-8编码：

input += new String(b, StandardCharsets.UTF_8);

2. 改用BufferedReader处理字符读取（推荐） #

手动读取字节的方式可能拆分UTF-8多字节字符（比如“ü”是2字节），导致解码错误。用BufferedReader包装输入流，自动处理字符边界：

修改步骤：

• 添加BufferedReader成员变量：

private BufferedReader stdOutReaderBuffered;
private BufferedReader stdErrReaderBuffered;

• 在Console()方法中初始化BufferedReader：

public void Console() {
    // ... 原有代码 ...
    try {
        PipedOutputStream stdOutPos = new PipedOutputStream(this.stdOutPin);
        System.setOut(new PrintStream(stdOutPos, true, "UTF-8"));
        stdOutReaderBuffered = new BufferedReader(new InputStreamReader(stdOutPin, StandardCharsets.UTF_8));
    } catch (java.io.IOException io) {
        // ... 错误处理 ...
    }
    // 同理初始化标准错误流的BufferedReader
    try {
        PipedOutputStream stdErrPos = new PipedOutputStream(this.stdErrPin);
        System.setErr(new PrintStream(stdErrPos, true, "UTF-8"));
        stdErrReaderBuffered = new BufferedReader(new InputStreamReader(stdErrPin, StandardCharsets.UTF_8));
    } catch (java.io.IOException io) {
        // ... 错误处理 ...
    }
    // ... 启动线程 ...
}

• 重写run()方法，去掉轮询和手动字节读取：

@Override
public void run() {
    try {
        if (Thread.currentThread() == stdOutReader) {
            String line;
            while ((line = stdOutReaderBuffered.readLine()) != null && !stopThreads) {
                StyleConstants.setForeground(style, Color.black);
                doc.insertString(doc.getLength(), line + "\n", style);
                textArea.setCaretPosition(doc.getLength());
            }
        } else if (Thread.currentThread() == stdErrReader) {
            String line;
            while ((line = stdErrReaderBuffered.readLine()) != null && !stopThreads) {
                StyleConstants.setForeground(style, Color.red);
                doc.insertString(doc.getLength(), line + "\n", style);
                textArea.setCaretPosition(doc.getLength());
            }
        }
    } catch (Exception e) {
        textArea.setText("\nConsole reports an Internal error.");
        textArea.setText("The error is: " + e);
    }
}

• 删除原有的readLine()方法。

3. 更换支持特殊字符的字体 #

MonoSpaced字体在部分系统上对德语变音符号支持不足，可更换为支持多语言的等宽字体，比如：

StyleConstants.setFontFamily(style, "Consolas");
// 或跨平台选项：
StyleConstants.setFontFamily(style, "DejaVu Sans Mono");

总结 #

核心问题是字节解码时未指定UTF-8编码，以及手动读取字节可能拆分多字节字符。通过明确编码或改用BufferedReader，配合支持特殊字符的字体，即可解决变音符号显示错误的问题。

内容的提问来源于stack exchange，提问作者Nox