Formatter 本身不输出，需指定 Appendable 目标；format() 不自动换行或刷新，须用 %n、flush() 或 try-with-resources 确保正确输出。
Java 中 Formatter 类本身不直接提供“格式化输出”功能，它只负责格式化字符串；真正完成输出的是配合它的目标（比如 System.out、StringBuilder 或文件流）。误以为调用 Formatter 构造方法就自动打印，是新手最常踩的坑。
Formatter 构造时必须指定输出目标
Formatter 是一个“写入器”，不是“打印机”。它需要一个 Appendable 实例来写入格式化后的内容。没指定目标，或目标为 null，会抛 NullPointerException；目标不可写（如只读流），会抛 IOException。
常见合法目标：
-
new Formatter(System.out)—— 输出到控制台（但通常更推荐用System.out.printf()） -
new Formatter(sb)，其中sb是StringBuilder—— 写入可变字符串 -
new Formatter(new File("out.txt"))—— 写入文件（需处理FileNotFoundException） -
new Formatter(ByteArrayOutputStream)—— 写入字节流，适合后续编码处理
format() 方法不会自动刷新或换行
调用 formatter.format("%d %s", 42, "hello") 只是把内容写入目标，不会追加 \n，也不会触发缓冲区刷新（尤其对文件或管道流）。这会导致：
立即学习“Java免费学习笔记（深入）”；
- 控制台输出粘连（多行挤在同一行）
- 文件写入后看不到内容（缓冲未刷出）
-
toString()在StringBuilder上取不到最新结果（如果中间没调用flush()或没 close）
正确做法：
- 显式加换行符：
formatter.format("%d %s%n", 42, "hello")（%n是平台安全的换行） - 手动刷新：
formatter.flush()（对流类目标必要） - 用 try-with-resources 自动 close（推荐用于文件）：
try (Formatter f = new Formatter("log.txt")) { f.format("[%tF %
Formatter 和 String.format() / printf() 的关键区别
三者共享同一套格式语法（%d、%s、%06x 等），但行为和生命周期不同：
-
String.format()：纯函数式，返回新字符串，无状态，线程安全 -
PrintStream.printf()（如System.out.printf()）：内部封装了Formatter，自动刷新，语义更贴近“输出” -
Formatter：有状态对象（维护位置、locale、输出目标），可复用，但需手动管理生命周期（flush/close），非线程安全
例如 locale 设置只对当前 Formatter 实例生效：new Formatter(Locale.FRANCE).format("%,.2f", 1234.5) 输出 1 234,50，而 String.format() 默认用系统 locale。
真正用好 Formatter，关键是把它当成“带格式能力的写入器”，而不是“高级 println”。目标选错、不 flush、忽略异常、混淆线程安全性——这些细节比格式语法本身更容易导致问题。
