PrintWriter与PrintStream区别详解

Java中PrintWriter与PrintStream的核心区别在于前者是面向字符的文本输出利器（支持显式编码、自动flush、异常静默不中断线程），后者是面向字节的兼容性选择（适用于二进制混合输出或System.out重定向，但易陷编码陷阱且需手动处理异常）；二者均非线程安全，多线程场景下直接使用会导致日志错乱或崩溃，必须加锁或迁移到专业日志框架——而真正让简单输出变成生产级稳定的，恰恰是深挖字符编码、缓冲刷新和并发安全这三个看似基础却极易踩坑的关键点。

PrintWriter 和 PrintStream 什么时候该选哪个？

PrintWriter 是字符流，PrintStream 是字节流——这是最根本的分水岭。你写的是纯文本、日志、配置内容，用 PrintWriter；你要输出二进制混合内容（比如 HTTP 响应头 + 图片数据），或者必须兼容老代码里硬写的 System.out（它本身就是 PrintStream 实例），那就得用 PrintStream。

• PrintWriter 支持指定字符编码（如 new PrintWriter(file, "UTF-8")），PrintStream 构造时只能传 File 或 OutputStream，编码靠底层 OutputStreamWriter 隐式处理，容易踩默认平台编码坑
• PrintWriter 的 printf()、format() 方法抛出的是未检查异常（RuntimeException），PrintStream 同名方法也是，但它的 write() 系列方法可能触发 IOException，而 PrintWriter 默认吞掉异常（除非你显式调用 checkError()）
• 日志记录场景下，PrintWriter 更安全：能控制编码、不意外中断线程（因异常被吞）、支持自动 flush（autoFlush = true）

PrintWriter.printf() 不生效？检查这三件事

printf() 看似调用了，文件却空着或内容不全——不是语法错，是流没刷出去。

• 没开自动 flush：new PrintWriter(out, true) 第二个参数必须为 true，否则换行符不会触发刷盘；只靠 println() 不够，printf() 不带换行
• 输出目标是文件但没 close：flush() 不等于 close()，尤其用 try-with-resources 时，别漏掉 close() 触发的最终 flush
• 编码不匹配导致乱码掩盖内容：比如用 GBK 打开 UTF-8 写入的文件，看着像“没输出”，其实是字节解码失败

示例：

try (PrintWriter pw = new PrintWriter("log.txt", "UTF-8")) {
    pw.printf("User %s logged in at %tF%n", username, System.currentTimeMillis());
    // 这里没 println()，也没 flush()，且 autoFlush=false → 内容卡在缓冲区
}

PrintStream.println() 为什么有时中文变问号？

根本原因是 PrintStream 底层用的是平台默认编码（Windows 是 GBK，Linux/macOS 通常是 UTF-8），而你写入的字符串是 UTF-16（Java 字符串内部格式），转换时若没显式指定，就按系统猜。

• 直接传 File 构造：new PrintStream("a.txt") → 完全依赖系统编码，跨平台必出问题
• 正确做法是包装 FileOutputStream + OutputStreamWriter，但那就绕过 PrintStream 了；更实际的解法是改用 PrintWriter，它构造函数明确支持编码字符串
• 如果非用 PrintStream（比如要重定向 System.out），必须用 new PrintStream(new FileOutputStream(f), true, "UTF-8")，第三个参数才是编码名

日志记录别直接用 PrintWriter/PrintStream 做并发写入

它们都不是线程安全的写操作类。多个线程同时调 println()，可能一行日志被截断、两行粘连、甚至抛 NullPointerException（因内部 lock 字段未初始化）。

• 单线程写文件没问题；多线程必须加锁，或用 java.util.logging.Logger、slf4j + logback 这类专为并发设计的日志框架
• 即使加了 synchronized，PrintWriter 的 checkError() 也不反映其他线程的错误状态，错误检测失效
• 小项目图快用 PrintWriter 记日志可以，但只要涉及定时任务、Web 请求、异步回调，就得切到真正线程安全的日志方案

字符编码、自动刷盘、线程安全——这三个点漏掉任何一个，都会让看似简单的输出变成深夜排查现场。

以上就是《PrintWriter与PrintStream区别详解》的详细内容，更多关于的资料请关注golang学习网公众号！