如何在 Java 中使用 Formatter 类像 C 语言的 printf 那样精细控制输出的宽度与对齐方式

Ja va Formatter 类：像C语言printf一样精细控制输出格式

如果你熟悉C语言的printf，那么上手Ja va的格式化输出会感到非常亲切。没错，Ja va的Formatter类（以及我们更常直接使用的String.format()和System.out.printf()）在设计上确实借鉴了C语言的语法。它同样支持通过格式说明符来精细控制输出的宽度、对齐、精度乃至进制转换。这一切的核心，就在于理解那个格式说明符的结构：%[argument_index$][flags][width][.precision]conversion。掌握了它，你就能让数据输出变得整齐又专业。

宽度与对齐：用 width 和 flags 控制占位与方向

想让输出列对齐，关键在于width和flags这对搭档。width定义了字段的最小宽度，如果内容本身长度不够，系统就会用空格（默认）或指定的字符来补足。至于内容在字段里是向左靠还是向右靠，那就得看flags了：

• -：这是最常用的对齐标志，表示左对齐。默认是右对齐，所以当你写下"%-10s"，就意味着字符串会靠左显示，并且整个字段一定会占满10个字符的宽度。
• 0：这个标志专为数字准备，表示用零来填充空白。比如"%08d"，数字12345会输出成00012345，前面补了三个零来凑足8位。
• （空格）：这个标志很有意思，它会在正数前面加一个空格，而负数依然显示-号。这样一来，正负数列就能完美地对齐了。例如"% 5d"，正数123会输出为" 123"。
• +：强制显示正负号。无论正数负数，前面都会带上+或-符号，"%+6d"输出正数就是"+123"。
• 关于居中对齐：这里需要特别澄清一点，Ja va标准库的Formatter并不直接支持像^这样的标志来实现居中对齐。网上有些资料可能会提到它，但这通常是第三方库的功能或是误解。如果真需要在Ja va中实现字符串居中，通常得手动计算空格，或者借助String.repeat()这类方法自己封装一个工具函数。

组合使用示例：字符串与数字的对齐控制

光说不练假把式，看一个组合使用的例子就全明白了：

System.out.printf("|%10s|%-10s|%010d|% 6d|%+6d|\n", "Hi", "Hi", 42, 42, -42);

这行代码的输出结果是：
| Hi|Hi |0000000042| 42| -42|
我们来拆解一下：
– %10s：右对齐，字符串“Hi”前面补了8个空格，总宽度为10。
– %-10s：左对齐，字符串“Hi”后面补了8个空格，总宽度同样为10。
– %010d：右对齐，数字42前面用零补足到10位。
– % 6d：右对齐，正数42前面有一个空格，总宽度为6。
– %+6d：右对齐，强制显示符号，负数“-42”前面有3个空格，总宽度为6。

自定义填充字符（需配合 Formatter 构造器）

默认的填充字符是空格，但有时候我们可能想用星号*、点号.或者其他字符来填充。标准的printf方法并不直接支持指定任意填充字符。不过，我们可以通过一些技巧来实现。一个常见的做法是，先按标准方式格式化，然后再替换空格：

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

static String padLeft(String s, int width, char pad) {
    return String.format("%" + width + "s", s).replace(' ', pad);
}
// 使用：padLeft("abc", 8, '*') → "*****abc"

当然，如果你用的Ja va版本在12以上，利用新的String.repeat()方法来实现这类对齐工具会更加直观和灵活。

精度（.precision）与类型适配

格式说明符中的.precision部分，其含义会根据后面的转换字符（conversion）不同而变化，这是需要特别注意的地方：
– 对字符串（s）而言，它表示截取的最大字符数。例如"%.5s"，即使字符串是“Hello World”，也只会输出“Hello”。
– 对浮点数（f）而言，它控制的是小数点后的位数。"%.2f"会让3.14159输出为3.14。
– 对整数（d）而言，精度的作用类似于width，但通常会和0标志搭配使用，来指定数字的最小位数。

最后务必牢记一点：转换字符（s, d, f, x等）必须与传入参数的实际类型严格匹配。如果试图用%d去格式化一个字符串，程序就会抛出IllegalFormatConversionException异常。细节决定成败，在格式化输出上尤其如此。