System.out.println 本质是 PrintStream 的 write + flush,因默认 autoFlush=true 且 println 触发隐式 flush,故立即输出;但 print() 或 write() 不刷新,重定向后易因缓冲或异常吞没导致无输出。

System.out.println 本质是 PrintStream 的 write + flush
System.out 不是普通变量,而是 java.lang.System 类中一个静态的 PrintStream 实例。它背后绑定的是 JVM 启动时初始化的标准输出流(通常是 FileOutputStream 包装的 BufferedOutputStream)。调用 println() 实际上会触发一连串操作:String.valueOf() 转换参数 → print() 写入缓冲区 → write('\n') → 最后隐式调用 flush()(仅当自动刷新开启时才真正刷出)。
为什么 println("hello") 会立刻出现在控制台?
因为 System.out 默认构造为自动刷新模式(autoFlush = true),但注意:这个“自动刷新”只对 println()、printf() 和 format() 生效,不适用于 print() 或直接调用 write()。也就是说:
-
System.out.print("hello");→ 可能卡在缓冲区,不立即显示 -
System.out.println("hello");→ 写完换行后强制flush() -
System.setOut(new PrintStream(out, false));→ 关闭自动刷新,此时println也不再自动刷出
常见陷阱:重定向 System.out 后日志没输出
用 System.setOut() 重定向到文件或自定义 PrintStream 时,容易忽略缓冲行为和异常吞没问题:
- 重定向后未调用
out.flush(),导致内容滞留在内存缓冲区 - 目标
OutputStream(如FileOutputStream)抛出IOException,而PrintStream默认静默吞掉异常(checkError()才能发现) - 多线程并发写入同一
PrintStream,可能因内部锁竞争或缓冲区错乱导致输出截断或乱序
验证是否出错可加判断:
if (System.out.checkError()) {
System.err.println("System.out has error!");
}
替代方案:Log4j / SLF4J 比 println 更可靠
开发中直接用 System.out.println 调试没问题,但上线后几乎必须替换。原因很实际:
立即学习“Java免费学习笔记(深入)”;
- 无法按级别(DEBUG/INFO/WARN)开关输出
- 不能动态切换输出目标(控制台/文件/网络)
- 没有格式化模板、MDC 上下文、异步刷盘等生产级能力
- JVM 参数(如
-Dfile.encoding=UTF-8)不影响System.out编码,但影响日志框架对中文的处理
哪怕只是临时调试,也建议用 System.err.println 区分错误流,避免被重定向的 stdout 影响关键提示。










