如何在Spring Boot中通过Logback实现日志文件的表格格式化输出？

首先得戳破你遇到的核心问题：SLF4J（Logback 基于它实现）的日志方法和 System.out.printf 的格式化逻辑完全不兼容。

看你的 log 方法：

public static void log(String format, Object... args) {
    System.out.printf(format, args);
    logger.info( format, args);
}

System.out.printf 能正确解析 %-16s 这类 printf 风格的占位符，生成对齐工整的表格字符串；但 logger.info() 只认 SLF4J 标准的 {} 占位符，它根本不会处理 %s 格式，而是直接把 format 字符串原样输出，同时把 args 作为日志参数附加（某些配置下会显示参数，但绝不会替换 %s）——这就是日志文件里表格格式混乱的根本原因。

解决方案 #

方案一：先统一格式化，再输出 #

最直接省心的解决方式是先把内容用 String.format() 格式化好，再同时输出到控制台和日志文件，确保两者用的是完全相同的对齐后字符串：

public static void log(String format, Object... args) {
    // 先完成格式化，得到对齐后的完整内容
    String formattedContent = String.format(format, args);
    // 输出到控制台
    System.out.print(formattedContent);
    // 输出到日志文件
    logger.info(formattedContent);
}

这样修改后，控制台和日志文件的表格格式会完全一致，对齐问题直接解决。

方案二：适配 SLF4J 占位符（可选） #

如果想保留 SLF4J 框架的特性（比如参数延迟加载、结构化日志支持），可以手动处理每个字段的对齐，再用 SLF4J 的 {} 占位符拼接。不过这种方式需要额外处理列宽对齐，示例如下：

public static void printListAsTable(List<ResultControl> resultcontrolList) {
    String separatorLine = "+------------------+---------------+---------------+--------------+---------------+---------------+--------------+--------------+";
    
    // 输出分隔线
    log(separatorLine);
    // 格式化表头（先对齐每个字段）
    String header = String.format("| %-16s | %-13s | %-13s | %-12s | %-13s | %-13s | %-12s | %-12s |",
                                  "Id", "Net", "Mat", "Dat", "Apo", "Nato", "Nano", "Pico");
    log(header);
    log(separatorLine);
    
    // 格式化每行数据
    for (ResultControl result : resultcontrolList) {
        String row = String.format("| %-16s | %-13s | %-13s | %-12s | %-13s | %-13s | %-12s | %-12s |",
                                  result.getId(), result.getNet(), result.getMat(), result.getDat(),
                                  result.getApo(), result.getNato(), result.getNano(), result.getPico());
        log(row);
    }
    log(separatorLine);
}

// 修改log方法，直接接收格式化后的字符串
public static void log(String message) {
    System.out.println(message);
    logger.info(message);
}

额外注意事项 #

1. 日志编码配置：确保 Logback 配置文件中日志文件的编码设置为 UTF-8，避免因字符编码差异导致的对齐问题（比如中文和英文字符宽度不一致的场景）。示例配置：

   <appender name="FILE" class="ch.qos.logback.core.FileAppender">
       <file>logs/app.log</file>
       <encoder>
           <charset>UTF-8</charset>
           <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
       </encoder>
   </appender>
   

2. 避免日志格式干扰：检查 Logback 的日志格式（pattern），不要添加额外的不必要空格或换行，确保输出的表格字符串不会被日志框架的格式破坏。

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