Java中StringBuilder适合构建多行结构化日志，需封装为链式MultiLineLogBuilder类，支持缩进控制、段落分隔、敏感字段脱敏及异常堆栈格式化输出。
Java 中 StringBuilder 本身不提供日志格式化功能，但它是非常适合构建多行、结构化日志字符串的底层工具。实现一个“自定义多行日志格式化输出器”，核心是用 StringBuilder 拼接带缩进、换行、字段对齐和上下文信息的文本块，而不是依赖日志框架的内置格式（如 Logback 的 %X{traceId}），而是手动控制每一行内容。
设计一个可复用的多行日志构建器
不要每次日志都手写 sb.append("...").append("
")，封装成类更清晰：
- 构造时传入基础信息（如时间、线程名、日志级别）
- 提供链式方法添加「段落」：请求头、参数、响应体、异常堆栈等
- 每段自动加前缀缩进（比如
" │ "或" "），并以空行分隔 - 最终调用
toString()返回完整多行字符串，供logger.info(builder.toString())输出
支持嵌套结构与缩进控制
多行日志常需体现层次，比如 HTTP 请求 → Headers → Body → Response。可用简单缩进计数模拟层级：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 内部维护一个
indentLevel，初始为 0 -
indent()方法将层级 +1，outdent()减 1 -
appendLine(String s)自动拼上前缀空格（如" ".repeat(indentLevel)）和换行 - 遇到 JSON 或 XML 内容，可调用第三方库（如 Jackson 的
defaultPrettyPrinter）美化后追加，避免手写换行缩进
处理特殊内容：异常堆栈与敏感字段脱敏
直接 e.printStackTrace(new PrintWriter(stringWriter)) 会生成多行字符串，但需注意：
立即学习“Java免费学习笔记（深入）”；
- 用
StringWriter + PrintWriter捕获堆栈，再逐行读取、每行前加缩进，避免破坏整体排版 - 对日志中的手机号、身份证号、token 等字段，在 append 前做正则替换（如
str.replaceAll("(\d{3})\d{4}(\d{4})", "$1****$2")） - 敏感字段建议统一走
mask(String raw)方法，而非散落在各处
示例：一个轻量级 MultiLineLogBuilder
代码片段示意（不含依赖）：
public class MultiLineLogBuilder {
private final StringBuilder sb = new StringBuilder();
private int indent = 0;
public MultiLineLogBuilder info(String msg) {
appendLine("INFO | " + msg);
return this;
}
public MultiLineLogBuilder section(String title) {
appendLine("─ " + title + " ─");
indent++;
return this;
}
public MultiLineLogBuilder kv(String key, Object value) {
String line = String.format("%-12s: %s", key, Objects.toString(value, "null"));
appendLine(line);
return this;
}
private void appendLine(String s) {
sb.append(" ".repeat(indent)).append(s).append("
");
}
public String toString() {
return sb.toString().trim(); // 去掉末尾多余换行
}
}
使用：
logger.debug(new MultiLineLogBuilder()<br>
.info("HTTP request start")<br>
.section("Request")<br>
.kv("Method", "POST")<br>
.kv("URL", "/api/user")<br>
.section("Headers")<br>
.kv("Auth", mask("Bearer abc123..."))<br>
.toString()); 
