Formatter适合精细格式化场景,通过格式化模式字符串写入StringBuilder、文件或输出流,支持对齐、本地化及重复调用;String.format更简洁,适用于单次字符串生成。

Java 的 Formatter 类适合需要精细控制输出格式的场景,尤其在拼接多类型数据、对齐字段、处理本地化时比简单字符串拼接更可靠。它底层基于格式化模式字符串(如 %s、%05d),支持写入到字符串、文件或任意实现了 Appendable 的目标(比如 StringBuilder 或 PrintStream)。
基础用法:构造 Formatter 并写入内容
Formatter 本身不直接返回字符串,而是把格式化结果“写入”指定目标。最常用的是写入 StringBuilder 再转成字符串:
- 创建空的
StringBuilder,传给Formatter构造器 - 调用
format()方法,传入格式串和参数 - 调用
toString()获取最终结果
示例:
StringBuilder sb = new StringBuilder();Formatter fmt = new Formatter(sb);
fmt.format("姓名:%s,年龄:%d,薪资:¥%,.2f", "张三", 28, 15800.5);
String result = sb.toString(); // → "姓名:张三,年龄:28,薪资:¥15,800.50"
常用格式化符号与对齐控制
格式占位符形如 %[flags][width][.precision]conversion,关键部分包括:
立即学习“Java免费学习笔记(深入)”;
-
%s:通用字符串;%d:十进制整数;%f:浮点数;%tY-%tm-%td:复用前一个时间参数(如日期) -
-左对齐,0补零,,千位分隔,+强制显示正负号 -
%10s:最小宽度 10,右对齐;%-10s:左对齐;%05d:不足 5 位前面补 0 -
%.2f:保留两位小数;%,.2f:带千分位+两位小数
写入文件或控制台的实用方式
Formatter 可直接绑定到文件或标准输出,避免手动管理缓冲区:
- 写入文件:
new Formatter(new File("output.txt"))(注意异常和关闭) - 写入控制台:
new Formatter(System.out),适合调试时结构化打印 - 推荐配合 try-with-resources 使用,确保自动关闭(尤其是涉及文件时)
示例(安全写文件):
try (Formatter fmt = new Formatter("report.txt")) {fmt.format("总计:%d 条记录,平均值:%.3f%n", count, avg);
}
对比 String.format 和 printf:什么时候选 Formatter?
String.format() 是静态封装,适合一次性生成字符串;System.out.printf() 是快捷打印;而 Formatter 的优势在于:
- 可重复调用
format()累积输出(比如循环生成表格行) - 支持自定义
Locale(如new Formatter(sb, Locale.FRANCE)影响小数点/千分位) - 能精确控制写入目标,适合日志模块、模板引擎等底层场景
如果只是拼一条日志或返回一个字符串,用 String.format() 更简洁;需要多次追加、定制输出流或本地化时,Formatter 更灵活。
基本上就这些。Formatter 不复杂但容易忽略它的“写入式”本质——它不是函数式转换,而是类似流的操作,理解这点就能避开大多数误用。










