stringbuilder是字符串工具类的核心组件，支撑高效可复用的字符串构建：支持安全拼接、路径格式化、sql条件生成、日志模板构造；需预估容量减少扩容；宜链式调用并统一处理null与边界情况。
在编写字符串工具类时，StringBuilder 是核心支撑组件——它让工具类真正具备高效、可复用、低开销的字符串构建与修改能力。直接用 String 拼接会频繁创建对象，而工具类一旦被多处调用，性能损耗会被放大；StringBuilder 则把所有操作收束到一个可变容器里，既干净又快。
适合封装成工具方法的操作类型
工具类不是重复暴露 StringBuilder API，而是聚焦高频、有明确语义的场景：
-
安全拼接带分隔符的集合：比如
join(List<string> list, String delimiter)</string>，内部用 StringBuilder 避免空字符串或 null 引发异常，同时跳过末尾多余分隔符 -
格式化路径或 URL 片段：如
buildPath(String... segments)，自动处理斜杠合并、去重和首尾清理，全程不产生中间 String -
生成 SQL WHERE 条件片段：动态拼接
name = ? AND age > ?，用 StringBuilder 累加条件，比字符串拼接节省 90% 以上临时对象 -
构造日志消息模板：例如
formatLog(String level, String module, Object... args)，先 append 固定前缀，再逐个处理参数，支持 null 安全转换
容量预估能显著减少扩容开销
工具类往往处理结构化数据，长度相对可预期。盲目用无参构造（默认 16 容量）在拼接长文本时会触发多次扩容（新容量 = 旧容量 × 2 + 1），带来复制成本。应在构造时合理预估：
- 拼接固定字段名 + 数值：按字段名总长 + 数值最大位数（如 int 最多 11 位）+ 分隔符数估算
- 生成 JSON 片段：预留左右括号、引号、冒号、逗号等符号空间，再加内容长度
- 不确定长度但有上限：直接传入最大可能长度，如
new StringBuilder(512)，避免运行时反复 resize
链式调用提升工具方法的可读性
工具类方法返回 StringBuilder 本身（而非 String），配合 void 方法设计，能自然形成流畅链式表达：
- 定义
public static StringBuilder addPrefix(StringBuilder sb, String prefix)和addSuffix(...) - 使用者可写成：
StrUtils.addPrefix(new StringBuilder(), "ID_").append(id).addSuffix("_v2") - 相比每次 toString() 再 new，链式避免了中间 String 对象，也更贴近 builder 模式语义
注意 null 和边界情况的统一处理
工具类要健壮，不能因输入异常崩掉 StringBuilder。常见做法：
- 对 null 输入统一转为字符串
"null"，而不是抛 NPE（除非业务明确要求） - insert/delete/replace 前校验索引范围，超出时静默忽略或截断，不抛 StringIndexOutOfBoundsException
- append 任意对象时调用
String.valueOf(obj)，兼容 null、数组、基本类型包装类
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
