在Java中Formatter类如何格式化输出内容_Java格式化工具说明

Formatter类的核心用途是格式化字符串而非输出，需手动指定Appendable目标并获取结果，不自动刷新或处理异常，性能与安全性低于String.format()。

Formatter类的核心用途是格式化字符串，不是输出到控制台

很多人误以为 Formatter 是类似 System.out.printf 的“打印工具”，其实它只负责格式化，不自动输出。它的作用和 String.format() 类似，但更底层、更灵活——你可以把它绑定到任意 Appendable（比如 StringBuilder、FileWriter、甚至自定义缓冲区），而不仅限于控制台或字符串。

常见错误现象：new Formatter().format("Hello %s", "World") 执行后没看到输出，是因为没调用 toS

tring() 或没写入目标流；也有人直接丢弃返回值，误以为已“生效”。

• Formatter 构造时必须指定输出目标（如 new Formatter(new StringBuilder())），否则抛 NullPointerException
• 格式化后需手动获取结果：若绑定的是 StringBuilder，调用 formatter.out().toString()；若绑定文件，需记得 close()
• 它不缓存中间状态，每次 format() 都追加到目标，不会覆盖

format() 方法的参数顺序和转换符必须严格匹配

Formatter.format(String format, Object... args) 是主要入口，但容易因参数数量或类型不匹配崩溃。Java 不做运行时类型推导，%d 遇到 String 会直接抛 IllegalFormatConversionException，而不是静默转成字符串。

典型错误场景：日志拼接中混用 %s 和 %d，但传参顺序错位，或把 null 传给 %d / %f。

• 推荐优先使用 String.format() 处理简单字符串，它内部就是用 Formatter 实现的，且更安全
• 需要复用格式器（如高频写文件）时才显式创建 Formatter，避免反复构造开销
• 调试时可先用 Objects.toString(x) 包裹可能为 null 的参数，再传入，防止 NullPointerException

Formatter 与 PrintWriter / System.out.printf 的关键区别

System.out.printf 看似和 Formatter.format() 一样，但底层封装了同步、异常吞并和自动刷新逻辑；而裸用 Formatter 没这些保障——尤其写文件时，不 close() 或不 flush() 可能导致内容丢失。

性能影响明显：频繁新建 Formatter 写小量数据，比复用一个绑定 PrintWriter 的实例慢 2–3 倍（JDK 17 测试，HotSpot JIT 后仍可见差异）。

• 写文件时，建议用 try (Formatter f = new Formatter(new FileWriter("log.txt", true))) { ... }，确保关闭
• 不要用 Formatter 替代 DecimalFormat 做数字本地化格式化（如千分位、货币符号），它不支持 Locale 感知的数字样式
• printf 是 PrintStream 的方法，本质是 new Formatter(out).format(...).flush() 的快捷封装

常见转换符陷阱：宽度、精度、标志的组合行为难预测

%-10.2f 这类复合格式串看似直观，但实际渲染依赖填充字符（默认空格）、对齐方向、是否补零等隐含规则。比如 %08d 对负数会变成 -0000123，而非补零在前；%.2f 对 NaN 输出 NaN，但 %.2e 会输出 NaN 而非科学计数法。

兼容性注意：Android API 21+ 和 OpenJDK 8+ 行为基本一致，但旧版 Android（如 4.x）对 %t 时间格式支持不全，部分转换符会静默失败。

• 时间格式尽量用 DateTimeFormatter 替代 %t 系列，后者语义模糊（%tY vs % 行为不同）
• 需要右对齐且固定宽度时，别依赖 %10s，先用 String.format("%10s", s) 测试边界值（空字符串、null、超长字符串）
• %% 表示字面量 %，不是 \%，反斜杠在格式串里无意义

细节容易被忽略：Formatter 不是线程安全的，多个线程共用同一个实例且并发调用 format()，输出会错乱或抛 IllegalStateException。如果要共享，必须外层加锁，或者每个线程用独立实例。