Logback 系列（6）：Pattern 布局语法速查

本系列第 6 篇。Pattern 决定日志长什么样，这篇当速查工具页收藏。

常用占位符

占位符	含义
%d{yyyy-MM-dd HH:mm:ss.SSS}	时间
%thread / %t	线程名
%-5level / %p	级别（-5 左对齐补空格）
%logger{50}	Logger 名（最多 50 字符缩写）
%msg / %m	日志内容
%n	换行
%X{traceId}	MDC 中的变量
%wEx	增强的异常堆栈

一个典型的文件 Pattern

<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>

输出效果：

2026-07-18 10:30:00.123 [http-nio-8080-exec-1] INFO  c.l.s.i.OrderService - 订单创建成功, id=123

关键技巧：截断超长日志

<pattern>... - %.-512000msg%n</pattern>

%.-512000msg 表示：msg 最长保留 512000 字符，超出从尾部截断。用于防止某条超大日志（比如打印了完整报文）撑爆磁盘。

截断规则记忆：

• %.30msg：超过 30 从尾部截（保留前 30 个字符）。
• %.-30msg：超过 30 从头部截（保留后 30 个字符）。

对齐与宽度

• %-5level：左对齐，宽度 5，不足补空格。
• %20logger：右对齐，宽度 20。
• %.30logger：最多 30 字符。
• %20.30logger：至少 20，最多 30。

---

上一篇：配置文件详解

下一篇：常用 Appender