如何使用 PrintStream 的 println 方法方便地格式化输出日志

浅伟大大_5016

浅伟大大_5016

2026-04-14

645人浏览

原创

printstream 的 println 不格式化,仅拼接字符串并换行;需格式化时用 printf/format;写文件须用 fileoutputstream 包装并指定 utf-8 编码、追加模式和自动刷新;生产日志应选 slf4j 等专业框架。

如何使用 printstream 的 println 方法方便地格式化输出日志

PrintStream 的 println 本身不格式化,只是拼接后换行

println 方法不会解析占位符或做类型格式化——它只把参数调用 String.valueOf() 转成字符串,再追加平台换行符(\r\n 或 \n)。所谓“方便”,其实是靠 Java 自动装箱 + toString() 隐式转换实现的,比如 println(123)、println(new Date()) 都能直接输出,但你无法控制小数位数、日期格式、对齐方式等。

真正需要格式化(如 "用户ID: %06d, 时间: %tF %tT")时,必须用 printf() 或 format(),它们才接受格式字符串和参数列表。

  • println("user=" + uid + ", time=" + new Date()) —— 简单但易出错,字符串拼接无类型安全,性能差
  • printf("user=%06d, time=%tF %tT%n", uid, now, now) —— 精确控制,但需注意 %n 是平台无关换行,%n 不等于 \n
  • 别混用:print("msg"); printf("data") 不会自动换行,容易漏 flush 导致日志滞留在缓冲区

写文件时必须用 FileOutputStream 包装,不能直接传路径

PrintStream 构造器**不接受 String 路径或 File 对象**。常见错误是写成 new PrintStream("app.log"),这会触发编译报错:找不到匹配构造方法。

正确链路是:先创建 FileOutputStream,再把它传进去。尤其要注意两个关键参数:

Upload audio to AIOZ Stream
Upload audio to AIOZ Stream

快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象,上传文件并完成处理后返回音频链接。

下载
  • 追加模式:用 new FileOutputStream("app.log", true),否则每次新建会清空原文件
  • 编码指定:默认用 System.getProperty("file.encoding")(Windows 常为 GBK),中文必乱码;必须显式传入 StandardCharsets.UTF_8
  • 自动刷新:第二个布尔参数设为 true,仅对 println、printf、format 生效,print() 不触发

完整写法示例:

PrintStream log = new PrintStream(new FileOutputStream("app.log", true), true, StandardCharsets.UTF_8);

System.setOut() 改变全局输出,但有隐藏风险

想让所有 System.out.println() 日志自动落盘?可以用 System.setOut(log)。这确实省事,但要注意:

  • 它修改的是 JVM 全局 out 流,其他模块(如第三方库、测试框架)的 System.out 输出也会被重定向,可能干扰诊断
  • 一旦设置,除非手动恢复(System.setOut(originalOut)),否则无法局部关闭
  • System.out 默认不 close(),但你包装的 PrintStream 必须在程序退出前 close(),否则缓冲区数据丢失
  • 多线程下若共享一个 PrintStream 实例,println 是线程安全的(内部同步),但性能会下降

比 PrintStream 更适合日志的替代方案

如果你真在做日志(而非临时调试输出),PrintStream 缺少关键能力:无日志级别、无时间戳自动注入、无滚动策略、无异常堆栈完整捕获。实际项目中更稳妥的选择是:

  • PrintWriter:字符流,天然支持 Charset,构造更简洁(Files.newBufferedWriter(Paths.get("log.txt"), UTF_8))
  • try-with-resources:避免忘记 close(),例如
    try (PrintWriter pw = Files.newBufferedWriter(Paths.get("log.txt"), UTF_8)) { pw.printf("[%s] %s%n", Instant.now(), msg); }
  • 真正生产级日志应跳过手写流,直接用 slf4j + logback 或 java.util.logging,它们内置异步、过滤、归档

用 PrintStream 写日志最易被忽略的点:你以为 println 会立刻写入磁盘,其实它只写进内存缓冲区;没关流、没 flush、没开 auto-flush,重启后日志就没了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

stream 格式化输出

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10277

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7402

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1124

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1356

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2709

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20031

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1195

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CentOS 官方文档
CentOS 官方文档

共0课时 | 0人学习

极客学院Java8新特性视频教程
极客学院Java8新特性视频教程

共17课时 | 4.3万人学习