PrintWriter 通过 printf/format 方法调用 Formatter 实现 C 风格格式化输出,支持 %s、%d、%.2f、%n 等格式符及对齐控制,需注意自动刷新与 UTF-8 编码设置。

Java 中 PrintWriter 用 printf 或 format 方法实现格式化写文本,底层调用 java.util.Formatter,语法和 C 风格 printf 完全一致,支持 %s、%d、%.2f、%n 等标准格式符。
基本格式化写法
PrintWriter 提供两个核心格式化方法:
-
printf(String format, Object... args):使用系统默认 locale -
format(String format, Object... args):同上,语义等价 -
format(Locale l, String format, Object... args):显式指定 locale,避免小数点/千分位因地区差异出错(如欧洲用逗号作小数点)
示例:
PrintWriter pw = new PrintWriter(System.out, true);
pw.printf("用户 %s 登录,ID:%d,耗时 %.3f 秒%n", "admin", 1001, 2.4567);
// 输出:用户 admin 登录,ID:1001,耗时 2.457 秒(换行自动刷新)
关键格式符与对齐控制
常用转换符直接对应数据类型,还能控制宽度、对齐、精度:
在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。
-
%s:任意对象,自动调用toString() -
%d:整数(int、long等) -
%.2f:浮点数,保留两位小数(四舍五入) -
%-10s:左对齐、最小宽度 10 的字符串(适合日志列对齐) -
%1$tY-%1$tm-%1$td:复用第 1 个参数(如LocalDateTime)提取年月日 -
%n:平台无关换行符(强烈推荐,替代\n)
示例(对齐日志):
pw.printf("[%1$tH:%1$tM:%1$tS] [%-7s] [%-15s] %s%n",
Instant.now(), "INFO", "UserService", "用户创建成功");
// 输出类似:[15:22:03] [INFO ] [UserService ] 用户创建成功
必须注意的刷新与编码问题
格式化内容不会立刻写出,容易“看似没输出”:
- 不启用自动刷新时,必须手动调用
pw.flush(),否则内容滞留在缓冲区 - 推荐构造时开启自动刷新:
new PrintWriter(out, true)—— 此时printf/format/println都会触发刷新 - 写文件或网络流时,务必指定字符编码,避免乱码:
new PrintWriter(new OutputStreamWriter(fileOut, StandardCharsets.UTF_8), true) - 不要用已废弃的构造器:
new PrintWriter(file, "UTF-8", true)(Java 11+ 已弃用)
实用封装建议
裸写 printf 易出错、难复用。可简单封装日志方法,统一时间、级别、格式:
- 定义固定前缀模板,如
"[%s][%s] %s%n" - 为
info、warn、error提供重载方法,自动注入时间、线程名、级别 - 支持可变参数,兼容任意数量的格式变量
- 内部仍用
printf,但对外隐藏格式细节,提升可读性和维护性
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










