Formatter类的核心用途是格式化字符串而非输出，需手动指定Appendable目标并获取结果，不自动刷新或处理异常，性能与安全性低于String.format()。
Formatter类的核心用途是格式化字符串，不是输出到控制台
很多人误以为 Formatter 是类似 System.out.printf 的“打印工具”，其实它只负责格式化，不自动输出。它的作用和 String.format() 类似，但更底层、更灵活——你可以把它绑定到任意 Appendable（比如 StringBuilder、FileWriter、甚至自定义缓冲区），而不仅限于控制台或字符串。
常见错误现象：new Formatter().format("Hello %s", "World") 执行后没看到输出，是因为没调用 toString() 或没写入目标流；也有人直接丢弃返回值，误以为已“生效”。
-
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。
立即学习“Java免费学习笔记（深入）”；
- 推荐优先使用
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系列，后者语义模糊（%tYvs%<ty> 行为不同）</ty> - 需要右对齐且固定宽度时，别依赖
%10s，先用String.format("%10s", s)测试边界值（空字符串、null、超长字符串） -
%%表示字面量%，不是\%，反斜杠在格式串里无意义
format()，输出会错乱或抛 IllegalStateException。如果要共享，必须外层加锁，或者每个线程用独立实例。 
