详解Java中的PrintWriter与PrintStream_格式化输出文本与日志记录

文章不知道大家是否熟悉？今天我将给大家介绍《详解Java中的PrintWriter与PrintStream_格式化输出文本与日志记录》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

该选PrintWriter还是PrintStream取决于数据类型和场景：纯文本/日志用PrintWriter（支持指定编码、自动flush、异常不中断线程）；二进制混合内容或兼容System.out时用PrintStream（需显式指定编码，注意平台默认编码陷阱），二者均非线程安全，多线程需加锁或改用专业日志框架。

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

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

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《详解Java中的PrintWriter与PrintStream_格式化输出文本与日志记录》文章吧，也可关注golang学习网公众号了解相关技术文章。