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免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
%s：通用字符串；%d：十进制整数；%f：浮点数；%tY-%<em>tm-</em>%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 不复杂但容易忽略它的“写入式”本质——它不是函数式转换，而是类似流的操作，理解这点就能避开大多数误用。
