Formatter类适用于需精细控制格式且解耦输出目标的场景,支持复用格式规则、指定Locale定制数字日期格式,通过StringBuilder高效构建字符串。

Formatter类适合需要精细控制输出格式、且不依赖打印流的纯格式化场景。它本身不负责输出到控制台或文件,而是把格式化后的字符串构造出来,交给开发者自行处理——比如拼接到日志、组装HTTP响应体、生成配置文本,或者作为函数返回值。它不是为“简单打印”设计的,而是为“可编程的格式构建”服务的。
需要解耦格式逻辑与输出目标时
当格式化结果要写入多个不同目的地(如同时记日志、发消息、存数据库),又不想重复写格式代码,Formatter就很有用。它把“怎么格式化”和“往哪输出”分开:
- 用new Formatter(new StringBuilder())构造,获取StringBuilder引用
- 调用format()方法填充内容,不触发任何I/O
- 最后用toString()拿到结果,再按需分发
需要复用同一套格式规则多次构造字符串时
比如生成一系列表格行、SQL插入语句、JSON片段等,每条结构相同但数据不同。Formatter支持重复调用format(),内部维护位置状态,比每次拼接String.format()更轻量(无临时String对象频繁创建):
- 创建一次Formatter实例,传入StringBuilder
- 循环中反复format("%s, %d, %.2f", name, age, score)
- 避免了每次调用String.format()都新建StringBuilder和解析格式串的开销
需要自定义Locale或特殊数字/日期格式时
Formatter构造时可指定Locale,影响小数点、千位分隔符、星期月份名称等。这对国际化应用很关键:
立即学习“Java免费学习笔记(深入)”;
- new Formatter(sb, Locale.US) → "1,234.56"
- new Formatter(sb, Locale.GERMAN) → "1.234,56"
- 日期格式如"%ta, %
会随Locale自动适配语言
不适合直接替代System.out.printf的场景
如果只是想在控制台快速打印调试信息,用System.out.printf()或String.format()更直接。Formatter多一层封装,还必须手动管理资源(调用close()释放内部锁和缓冲区,尤其用File或OutputStream时):
- 忘了close()可能导致资源泄漏(特别是写文件时)
- 单次格式化用String.format()更简洁
- 实时日志输出通常走Log4j/SLF4J等框架,它们内部已优化格式逻辑,无需手动介入Formatter










