stringbuilder拼接日志需预估容量、分段追加、避免中间tostring、统一换行、过滤敏感字段、结合日志级别开关，六点到位性能提升超八成。
用 StringBuilder 拼接日志，核心不是“能不能拼”，而是“怎么拼不白费力气”——预估容量、分段追加、避免中间转字符串、统一换行、过滤敏感字段、配合日志级别开关，这六点踩准了，性能开销能降八成以上。
预分配足够容量，减少扩容拷贝
默认 16 字符容量在日志场景下极容易触发多次扩容。每次扩容都要复制整个底层数组（新容量 ≈ 旧容量 × 2 + 1），10 行日志每行平均 80 字符，就该直接 new StringBuilder(1000)；含变量时把固定前缀（如 "[DEBUG][2026-08-20] " 约 25 字）、ID（最多 16 位）、消息体（均值 100）加总，设 180～200 更稳妥。不确定时宁可略大，别用默认构造拼几十行。
按逻辑分块 append，绝不中途 toString()
日志常含时间戳、方法名、参数、异常堆栈等不同来源内容，应一次性构建完再调 toString()。中间调用 toString() 会生成无用 String 对象，彻底失去 StringBuilder 的意义：
- ✅ 正确：sb.append("[").append(LocalDateTime.now()).append("] ").append("method: ").append(methodName)
- ❌ 错误：log.debug(sb.toString()); sb.append(" — extra info"); log.debug(sb.toString());（重复创建 + 可能漏内容）
统一换行与空值处理，避免隐式开销
多行日志必须用 System.lineSeparator()，而非 "\n" 或 "\r\n"，确保跨平台兼容；字段可能为 null，直接 sb.append(obj) 会写入 "null" 字符串，应统一用 String.valueOf(obj)（对 null 返回空字符串）或 Objects.toString(obj, "[null]")。避免在 append 中写 " | " 这类小字符串，改用 append(' ') 或 append('|') 单字符更轻量。
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
控制对象打印深度，主动过滤敏感字段
调用 sb.append(userDto) 很方便，但若 DTO 有循环引用或重写了巨长 toString()，可能引发 StackOverflowError 或刷屏日志。集合打印要限制数量：list.subList(0, Math.min(5, list.size()))；密码、token、手机号等字段不能依赖默认 toString()，应在拼接前显式替换或跳过。复杂对象优先走专用调试方法，比如自定义 debugToString()。
结合日志级别开关，只在需要时拼接
StringBuilder 是拼接工具，不是日志门面。生产环境必须通过 SLF4J / Log4j 输出，且拼接逻辑要包裹在日志级别判断内：
- ✅ 推荐：if (log.isDebugEnabled()) { StringBuilder sb = new StringBuilder(512); sb.append(...); log.debug(sb.toString()); }
- ❌ 危险：log.info("user: {}", sb.toString());（即使 info 关闭，拼接也已执行完毕）
不复杂但容易忽略：一次预估容量比十次微优化更有效；null 处理和线程隔离（局部变量实例）是零成本高回报动作；toString() 只调一次，且只在真正要输出时才调。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
