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免费学习笔记（深入）”；
Java 接口排错助手
下载
在调试 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，但对外隐藏格式细节，提升可读性和维护性
