Formatter类的核心作用是构建格式化字符串而非直接输出，它需绑定Appendable（如StringBuilder）并调用toString()获取结果，不自动打印且非线程安全。
Formatter类的核心作用不是“输出”，而是“构建格式化字符串”
很多人误以为 Formatter 是类似 System.out.printf 的直接输出工具，其实它不负责打印——它只负责按模式生成字符串。真正输出得靠你自己调用 toString() 或写入 Appendable（比如 StringBuilder 或文件流）。如果你期望它自动打印到控制台，会发现什么也没发生。
常见错误现象：
- 构造了 Formatter 但没调用 toString()，变量值看起来是空的或未初始化
- 传入 System.out 作为目标，却没意识到这不会自动刷新，且后续调用可能覆盖前一次内容
- 推荐做法：优先绑定
StringBuilder，最后用sb.toString()获取结果 - 若写入文件，确保
Formatter关闭（或用 try-with-resources 包裹FileOutputStream） - 避免重复使用同一个
Formatter实例做多次独立格式化——内部状态（如写入位置）会累积影响结果
format() 方法的参数顺序和类型必须严格匹配格式串
Formatter.format() 的第一个参数是格式化模板（如 "%s: %d"），后面跟的是对应占位符的实际值。Java 不做运行时类型推导，%d 后面如果传了 String，会直接抛 IllegalFormatConversionException；%f 传了 int 也会失败。
容易踩的坑：
- 把 LocalDateTime.now() 直接塞进 %tY 占位符，忘了它需要 TemporalAccessor，而 LocalDateTime 符合，但 Date 才是传统常用类型，二者混用易出错
- 使用 %n 换行时，在 Windows 上生成 \r\n，Linux 上是 \n，若写入文本文件又手动拼 \n，会导致双换行
- 调试技巧：先用
String.format()验证模板和参数是否匹配，再迁移到Formatter - 对时间类型，优先用
DateTimeFormatter（Java 8+），Formatter的%t*系列支持有限且不易读 - 浮点数精度控制别只依赖
%.2f——它四舍五入，但不控制有效位数或科学计数法切换，复杂需求建议用BigDecimal+DecimalFormat
Formatter 和 String.format()、System.out.printf() 的本质关系
三者共享同一套格式语法（java.util.Formatter 规范），但封装层级不同：
- String.format() 是静态方法，内部 new 一个 Formatter，写入 StringBuilder，返回字符串
- System.out.printf() 底层调用的是 PrintStream.format()，后者也是基于 Formatter，目标是 System.out
- 显式使用 Formatter 类，是为了复用写入目标（如反复写入同一 StringBuilder）、或对接自定义 Appendable
性能与场景选择：
- 简单一次性格式化 → 用 String.format()，语义清晰，无资源管理负担
- 高频拼接（如日志消息组装）→ 复用 Formatter + StringBuilder 可减少对象创建，但要注意线程不安全
- 写入文件/网络流 → 显式构造 Formatter 并传入对应流，但务必注意异常后流是否关闭
-
Formatter实例不是线程安全的，多线程共用必须加锁或改用无状态方式（如每次 new） -
String.format()每次都新建Formatter和StringBuilder，短字符串下开销可忽略，但循环内高频调用可能触发 GC - 不要为了“统一风格”强行把所有
printf替换为Formatter实例——多数场景没必要
StringBuilder sb = new StringBuilder();
Formatter fmt = new Formatter(sb);
fmt.format("User %s logged in at %tF %格式化逻辑本身不难，难的是在复用、线程、资源释放、类型匹配这些边界上保持一致——尤其当模板来自配置或用户输入时，Formatter 的异常不会静默吞掉，但堆栈信息往往不够直白。
