autoFlush=true仅对println()、printf()、format()生效，print()和write()仍需手动flush；正确做法是OutputStreamWriter包装Socket流并指定UTF-8编码，且PrintWriter构造时传true。
为什么 autoFlush 设为 true 也不一定实时？
因为 PrintWriter 的自动刷新只对 println()、printf()、format() 这三类方法生效，调用 print() 或直接写入 write() 不会触发刷新——哪怕 autoFlush 是 true。网络流（如 Socket.getOutputStream() 包装的 OutputStreamWriter）底层依赖缓冲区，不刷出就卡在本地 JVM 缓冲里，对方收不到。
常见错误现象：print("hello"); 发送后对方 socket 一直阻塞等待，println("hello") 却立刻收到——本质是换行符触发了 flush，不是 autoFlush 在“全程兜底”。
- 必须用
println()/printf()/format()才能靠autoFlush=true自动下发 -
print()后必须手动调用flush()，否则数据滞留 - 若协议不要换行符（如二进制指令、JSON 行协议无
\n），autoFlush=true实际失效
如何正确包装 Socket 输出流并启用 autoFlush
关键在于构造链路：从 Socket.getOutputStream() → OutputStreamWriter（指定编码）→ PrintWriter，且 autoFlush 必须传 true。不能跳过 OutputStreamWriter 直接套 PrintWriter（否则默认平台编码，跨环境易乱码）。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
Socket socket = new Socket("localhost", 8080);
// ✅ 正确：显式指定 UTF-8，autoFlush=true
PrintWriter out = new PrintWriter(
new OutputStreamWriter(socket.getOutputStream(), StandardCharsets.UTF_8),
true // ← 这个 true 就是 autoFlush
);
- 不要用
new PrintWriter(socket.getOutputStream(), true)：它用平台默认编码，Windows 和 Linux 表现不一致 - 如果服务端是 Node.js/Python 等，默认按 UTF-8 解码，Java 端不指定编码会导致中文变成
??? - 构造后无需再调用
out.flush()—— 但前提是用println()类方法
遇到粘包或延迟接收时，先检查这三件事
即使 autoFlush=true 且用了 println()，对方仍收不到，大概率是缓冲链路中某环没被触发。网络栈有至少三层缓冲：JVM 的 PrintWriter 缓冲、OutputStreamWriter 内部缓冲、TCP 栈的 Nagle 算法缓冲。
立即学习“Java免费学习笔记（深入）”；
- 确认服务端读取逻辑是否阻塞在
readLine()或等\n：如果 Java 端发的是print("data")而非println("data")，对方永远等不到换行，也就不会返回 - 禁用 Nagle 算法：
socket.setTcpNoDelay(true)，避免小包合并延迟（尤其高频短消息场景） - 别依赖
close()触发最后 flush：close()会 flush，但连接断开后无法再发，且部分服务端对半关闭不敏感；实时下发必须靠主动println()或flush()
替代方案：不用 PrintWriter 怎么保证实时？
当协议不允许换行（如自定义二进制头+长度域）、或需混合文本/字节操作时，PrintWriter + autoFlush 天然不适用。此时应绕过它，直接操作带缓冲控制的底层流。
// ✅ 更可控：用 BufferedWriter + 显式 flush
BufferedWriter writer = new BufferedWriter(
new OutputStreamWriter(socket.getOutputStream(), StandardCharsets.UTF_8)
);
writer.write("data");
writer.newLine(); // 写 \n
writer.flush(); // 强制刷出，不依赖 autoFlush
-
BufferedWriter的flush()是确定性行为，比PrintWriter的自动逻辑更可预测 - 若要写原始字节（如协议头），直接用
socket.getOutputStream().write(byte[])+flush()，避开字符流编码层 - 注意：所有
flush()调用都可能抛IOException，网络中断时会暴露，别忽略异常处理
autoFlush=true 很容易给人一种“设了就万事大吉”的错觉。实际它只守着三个方法的入口，其余全是盲区。最稳妥的做法，是把刷新时机收归自己控制——该 flush() 的地方写清楚，比赌 autoFlush 的触发条件更可靠。 
