如何用Java格式化实现带冒号后缀的对齐两列表格输出？

固定字段名的简单实现 #

问题根源是你把冒号放在了填充空格之后，正确的做法是将字段名+冒号作为一个整体做左对齐填充，这样冒号会紧跟字段名，后续空格填充到指定宽度后，字段值自然对齐。

修改后的代码：

StringBuilder builder = new StringBuilder();
Formatter formatter = new Formatter(builder, Locale.US);
// 将冒号与字段名合并为一个格式化单元，左对齐到35个字符宽度
String format = "%n    %-35s%s";
formatter.format(format, "Request name:", requestName);
formatter.format(format, "Request description:", requestDescription);

// 输出结果
System.out.println(builder);

输出效果：

Request name:                       shareUtilReq-321
Request description:                Requesting file Cov-22

可变字段名的通用方案 #

如果字段名是动态生成、长度不固定的，需要先计算所有"字段名:"的最大长度，再动态生成格式化字符串，确保所有字段值的起始列对齐。

示例代码：

// 模拟动态字段集合
Map<String, String> fieldMap = new HashMap<>();
fieldMap.put("Request name", "shareUtilReq-321");
fieldMap.put("Request description", "Requesting file Cov-22");
fieldMap.put("User ID", "U-7890");
fieldMap.put("File size", "2.4MB");

// 计算所有"字段名:"的最大长度
int maxLabelLength = fieldMap.keySet().stream()
    .mapToInt(key -> (key + ":").length())
    .max()
    .orElse(0);
// 额外添加空格（比如5个）优化排版间距
int targetWidth = maxLabelLength + 5;

StringBuilder builder = new StringBuilder();
Formatter formatter = new Formatter(builder, Locale.US);
// 动态生成格式化规则
String format = "%n    %-" + targetWidth + "s%s";

// 遍历输出所有字段
for (Map.Entry<String, String> entry : fieldMap.entrySet()) {
    formatter.format(format, entry.getKey() + ":", entry.getValue());
}

System.out.println(builder);

输出效果：

Request name:                       shareUtilReq-321
Request description:                Requesting file Cov-22
User ID:                            U-7890
File size:                          2.4MB

内容的提问来源于stack exchange，提问作者kc2001