JavaPrintWriter输出方法全解析

本文深入剖析了Java中PrintWriter的三大核心陷阱：缓冲区刷新机制（不自动刷新导致输出丢失，需显式flush或构造时启用自动刷新）、字符编码控制（未指定UTF-8等显式编码极易引发跨平台中文乱码）、以及线程安全性局限（非完全线程安全，多线程共享易出错，应独立实例或改用专业日志框架），并对比了它与BufferedWriter+OutputStreamWriter在异常处理和适用场景上的本质差异——帮你避开那些悄无声息却极难排查的“静默失败”坑。

PrintWriter 默认不自动刷新缓冲区，不加 flush() 或启用自动刷新，写入内容可能根本不会出现在目标位置。

为什么 println() 有时没输出？

这是最常踩的坑：创建 PrintWriter 时未启用自动刷新，且忘记手动调用 flush()。它的缓冲机制和底层流（如 FileOutputStream）不同——println()、print() 只是把数据塞进内部缓冲区，并不保证立即写出。

• 构造时传 true 启用自动刷新：new PrintWriter(outputStream, true)
• 或每次写完手动调用：pw.println("data"); pw.flush();
• 关闭流（close()）会隐式刷新一次，但不能依赖它做实时输出

PrintWriter 与 BufferedWriter + OutputStreamWriter 的区别

三者都能写文本，但职责和容错性不同：

• PrintWriter：屏蔽底层 I/O 异常，所有 print 类方法声明为 throws no exception；错误通过 checkError() 查询，适合“尽力而为”的日志场景
• BufferedWriter + OutputStreamWriter：异常直接抛出（如 IOException），更利于定位问题，推荐用于需要强错误反馈的业务逻辑
• PrintWriter 的 printf() 和格式化支持更方便，但编码由 OutputStreamWriter 控制，构造时需显式指定字符集（如 new OutputStreamWriter(new FileOutputStream("a.txt"), "UTF-8")）

向文件写入时中文乱码怎么办？

根本原因是未指定字符编码，默认使用平台编码（Windows 是 GBK，Linux/macOS 多为 UTF-8），跨平台极易出错。

PrintWriter pw = new PrintWriter(
    new OutputStreamWriter(
        new FileOutputStream("log.txt"), 
        "UTF-8"
    ), 
    true
);

• 绝对不要用 new PrintWriter("log.txt") —— 它内部用 FileOutputStream 构造，字符集不可控
• 如果用 Files.newBufferedWriter()（Java 7+），可直接传 StandardCharsets.UTF_8
• 终端输出（System.out）乱码通常与 IDE 或终端编码设置有关，和 PrintWriter 本身无关

能否安全地在多线程中共享一个 PrintWriter？

不能。虽然 PrintWriter 的部分方法有内部同步（如 println()），但它**不是线程安全的完整实现**——例如 printf() 的格式化与写入是两步操作，中间可能被其他线程打断。

• 多个线程写同一文件，应各自持有独立的 PrintWriter 实例（注意文件并发写入冲突）
• 若必须复用，需外层加锁（如 synchronized(pw) { pw.println(...); }），但会严重降低吞吐
• 高并发日志场景，优先考虑 java.util.logging、Log4j 或 SLF4J 等专业方案

真正麻烦的从来不是“怎么写”，而是“什么时候刷出去”和“用什么编码写”。这两个点一旦设错，现象就是静默失败或乱码，排查起来比编译错误更耗时间。

今天关于《JavaPrintWriter输出方法全解析》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！