JavaPrintWriter与PrintStream：输出格式与日志技巧

本文深入剖析了Java中PrintWriter与PrintStream的核心差异与适用场景：前者是面向字符的文本输出利器，支持显式编码、自动刷盘和异常静默处理，特别适合日志记录和纯文本操作；后者是面向字节的通用输出流，虽兼容System.out等传统用法，却易陷于平台默认编码陷阱且I/O异常更敏感。文章直击开发中三大高频痛点——编码乱码、缓冲区未刷新导致内容丢失、多线程并发写入引发数据错乱，并强调二者均非线程安全，中小项目可谨慎使用，而真实生产环境（尤其涉及Web、定时任务或异步场景）务必升级至专业日志框架，避免在看似简单的输出逻辑上耗费大量排查精力。

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 请求、异步回调，就得切到真正线程安全的日志方案

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

本篇关于《JavaPrintWriter与PrintStream：输出格式与日志技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！