JavaFormatter格式化输出教程

Java中格式化输出应优先选用简洁安全的String.format()或printf()，而非直接使用底层复杂且线程不安全的Formatter类——后者易引发空指针、资源泄漏、缓冲区覆盖等隐患；同时需警惕默认Locale导致的中英文环境差异（如小数点变逗号、月份名本地化），务必显式指定Locale.US等标准区域设置；对于含重复占位、条件逻辑或国际化需求的复杂场景，则应转向更健壮的MessageFormat或专业模板引擎。

Java 中的 Formatter 类本身不推荐直接用于日常格式化输出——它底层能力强大但接口笨重、易出错，真正该用的是 String.format()、System.out.printf() 或 PrintStream.printf() 这些封装好的入口。

为什么别直接 new Formatter()？

Formatter 是一个状态可变、线程不安全、且需手动管理资源（比如写入目标）的类。常见误用是创建后忘记绑定输出目标，或在多线程中共享实例导致输出错乱。

• 没指定 Appendable 构造参数时，new Formatter() 会抛 NullPointerException
• 用 Formatter 写文件却忘了 close()，可能丢失最后缓冲内容
• 它的 format() 方法返回 this，容易让人误以为能链式调用多次不同格式，实际每次调用都会覆盖前一次结果（内部复用缓冲区）

String.format() 和 printf() 的本质区别

二者底层都用 Formatter，但封装层级不同：String.format() 返回新字符串；System.out.printf() 直接写到控制台，不返回值。

• String.format("%d %s", 42, "answer") → 返回 "42 answer"
• System.out.printf("%d %s%n", 42, "answer") → 打印并换行，返回 PrintStream 实例（常被忽略）
• 格式说明符必须与参数类型严格匹配，否则抛 IllegalFormatConversionException，例如用 %d 格式化 Double
• %n 是平台无关换行符，比 \n 更安全

常见格式化陷阱与修复

中文环境下最容易踩的坑是 locale 导致的小数点、千分位、日期缩写异常。默认使用 JVM 启动时的 locale，不是系统 locale。

• 浮点数用 %.2f 输出时，如果 locale 是 de_DE，小数点会变成逗号："3,14" —— 解决：显式传入 Locale.US
• 日期格式如 %tB（完整月份名）在 zh_CN 下输出“一月”，在 en_US 下输出“January”，不指定 locale 会导致测试环境与生产环境不一致
• 正确写法：String.format(Locale.US, "%.2f %tB", 3.1415, new Date())

String result = String.format(Locale.US, "Price: $%,.2f, Date: %1$td %1$tB %1$tY", 1999.99, new Date());
// 输出：Price: $1,999.99, Date: 05 January 2024（注意：第二个参数未被使用，%1$ 表示复用第一个）

替代方案：什么时候该用 MessageFormat？

当格式化模板含重复占位、带条件、或需要国际化（i18n）时，Formatter 系列就力不从心了。MessageFormat 支持占位符复用、选择格式（如 {0,choice,0#zero|1#one|1

• 它不依赖 locale 做基础解析，但子格式（如 date、number）仍受 locale 影响
• 模板字符串里大括号要双写："{0} says ''{1}''" → "{0} says ''{1}''"（单引号需转义）
• 不支持 %n，换行得用 \n 或拼接

真正复杂格式化逻辑（比如生成带对齐、颜色、嵌套结构的日志或报告），别硬扛 Formatter，该上模板引擎（如 StringTemplate、Mustache）或专用 DSL。

以上就是《JavaFormatter格式化输出教程》的详细内容，更多关于的资料请关注golang学习网公众号！