如何通过 PrintWriter 在 Java 中高效实现网络流格式化文本输出？

本文共计880个文字，预计阅读时间需要4分钟。

《 PrintWriter 使用指南：

为什么不能直接 new PrintWriter(socket.getOutputStream())

Socket 的 OutputStream 默认不带缓冲，且 PrintWriter 的 println() 等方法在底层调用 write() + flush() 时，若未启用自动刷新（autoFlush=true），数据可能卡在缓冲区里发不出去——对方收不到任何内容，调试时看似“没反应”。

常见错误现象：socket.getOutputStream().write("HELLO\n".getBytes()) 能通，但换成 pw.println("HELLO") 就收不到。

• 必须显式传入 true 启用自动刷新：new PrintWriter(socket.getOutputStream(), true)
• 更稳妥的做法是：先套一层 BufferedOutputStream（尤其在高吞吐场景），再交给 PrintWriter
• 字符编码必须明确指定，否则依赖平台默认编码（如 Windows 的 GBK），和服务端不一致就乱码

正确构造支持 UTF-8 的 PrintWriter 实例

绕过平台默认编码、避免字节流与字符流转换失真，关键在用 OutputStreamWriter 桥接，并指定 UTF-8：

立即学习“Java免费学习笔记（深入）”；

OutputStream out = socket.getOutputStream(); PrintWriter pw = new PrintWriter( new OutputStreamWriter(out, StandardCharsets.UTF_8), true // autoFlush );

注意：StandardCharsets.UTF_8 是 Java 7+ 推荐写法；若用字符串 "UTF-8"，需捕获 UnsupportedEncodingException（虽实际不会抛）。

• 不要用 new PrintWriter(out, "UTF-8", true) —— 这个构造器在 Java 11+ 已被标记为 @Deprecated
• 如果服务端协议要求换行符为 \r\n（如 HTTP、SMTP），println() 在 Windows 上输出 \r\n，Linux/macOS 输出 \n，此时应改用 print("xxx\r\n") + flush()

写入时哪些操作会触发 flush

PrintWriter 的自动刷新只对 println()、printf()、format() 生效，不包括 print() 或 write()。

• pw.print("DATA"); → 不 flush，数据滞留
• pw.println("DATA"); → 自动 flush（前提是构造时设了 true）
• pw.printf("ID: %d", 123); → 自动 flush
• 手动调用 pw.flush() 总是安全的，适合批量写入后统一刷出

典型陷阱：循环中混用 print() 和 println()，结果只有最后一行被刷出，前面全卡住。

关闭顺序和异常风险

PrintWriter 关闭时会调用底层 Writer 的 close()，进而关闭 OutputStream —— 也就是关闭 Socket。但若在写入中途异常（如网络中断），checkError() 才能发现底层流已失效。

• 务必在 finally 或 try-with-resources 中关闭 PrintWriter
• 调用 pw.checkError() 可检测是否发生 I/O 错误（例如远端断连后继续写入），返回 true 表示出错，但不会抛异常
• 不要在 PrintWriter 关闭后还调用 socket.close()，会抛 IOException

真正容易被忽略的是：PrintWriter 对异常“静默”——写失败不会立即抛 IOException，得靠 checkError() 主动查；而很多业务逻辑只看 println() 是否返回，就以为成功了。