Java中Formatter格式化字符串的用法详解

Formatter类用于格式化文本输出，核心是格式说明符，支持字符串、数字、日期等精确控制，适用于日志、报表等场景，需注意资源关闭、参数匹配及线程安全问题。

在Java中，Formatter类是一个功能强大的工具，用于格式化文本输出。它基于格式字符串和参数生成格式化的结果，常用于日志记录、报表生成或控制台输出等场景。虽然我们更常用String.format()或System.out.printf()，但这些方法底层其实都依赖于java.util.Formatter类。下面详细介绍其核心用法。

Formatter的基本使用方式

Formatter通过构造函数创建实例，然后调用format()方法进行格式化。最终可通过toString()获取结果。

示例：

Formatter formatter = new Formatter();
formatter.format("姓名：%s，年龄：%d", "张三", 25);
String result = formatter.toString(); // 输出：姓名：张三，年龄：25
formatter.close(); // 注意关闭资源

也可以将格式化内容写入StringBuilder或文件流等目标中。

格式说明符详解

格式化的核心是格式说明符，以%开头，控制参数的输出形式。基本结构为：

立即学习“Java免费学习笔记（深入）”；

%[argument_index$][flags][width][.precision]conversion

各部分含义如下：

• conversion（转换符）：决定数据类型如何显示，如%s（字符串）、%d（整数）、%f（浮点数）、%t（时间日期）等
• width：最小字段宽度，不足时填充空格
• .precision：精度，对浮点数表示小数位数，对字符串限制最大长度
• flags：如-（左对齐）、+（正数显+号）、0（补零）等
• argument_index$：指定第几个参数，可重复使用参数

常见转换符示例：

• %d：格式化整数，formatter.format("%d", 100) → “100”
• %f：格式化浮点数，formatter.format("%.2f", 3.14159) → “3.14”
• %s：格式化字符串，formatter.format("%10s", "hi") → ” hi”（右对齐10字符宽）
• %tc：完整日期时间，formatter.format("%tc", new Date())
• %n：换行符（推荐代替n，跨平台兼容）

实际应用场景与技巧

Formatter适合需要精确控制输出格式的场合。

1. 数字对齐与补零

银行编号或ID常需固定长度：

formatter.format("%08d", 123) → “00000123”

查看详情

2. 浮点数保留两位小数

formatter.format("%.2f", 123.4) → “123.40”

3. 多参数重复使用

formatter.format("%2$s %1$d %2$s", 100, "abc") → “abc 100 abc”

4. 表格对齐输出

打印整齐的表格时非常有用：

formatter.format("%-10s %-10s%n", "姓名", "分数");
formatter.format("%-10s %-10.2f%n", "小明", 87.5);

其中%-10s表示左对齐、宽度10的字符串。

注意事项与最佳实践

使用Formatter时注意以下几点：

• 若Formatter关联了可关闭资源（如文件流），务必调用close()释放
• 格式字符串中的参数数量和类型必须匹配，否则运行时报IllegalFormatException
• 在高并发场景中，Formatter不是线程安全的，不要共享实例
• 简单格式化建议用String.format()，更简洁

基本上就这些。掌握Formatter有助于处理复杂文本格式需求，尤其在生成报告或导出数据时非常实用。理解格式说明符的结构是关键，多练习几种常见模式就能熟练运用。

以上就是Java中Formatter格式化字符串的用法详解的详细内容，更多请关注php中文网其它相关文章！