StringBuilder 核心是分阶段构建、条件控制与可维护结构，适用于动态高、分支多、性能敏感场景；需按逻辑分块追加、避免嵌套混杂、预估容量、禁止线程共享，并注意分隔符处理与 toString() 副本特性。
Java 中用 StringBuilder 实现复杂字符串格式化，核心不是“拼接”，而是“分阶段构建 + 条件控制 + 可维护结构”。它适合动态性高、分支多、性能敏感的场景（比如日志模板、SQL 拼装、HTML 片段生成），但需避免过度嵌套和逻辑混杂。
按逻辑分块构建，而非一行拼到底
把长字符串拆成语义清晰的片段，每块独立追加，便于阅读和调试。例如生成带前缀、用户信息、时间戳和状态的审计日志：
StringBuilder log = new StringBuilder();
log.append("[AUDIT] "); // 固定前缀
log.append("user=").append(userId); // 用户标识
if (orderId != null) {
log.append(", order=").append(orderId);
}
log.append(", ts=").append(System.currentTimeMillis());
log.append(", status=").append(status.name());
比起写成 new StringBuilder().append("...").append("...")... 一长串，这种写法更易定位某段逻辑、增删字段或加空格/逗号分隔符。
用 append() 链式调用 + 条件判断控制内容
StringBuilder 的 append() 返回自身，支持链式调用；配合 if/switch 可灵活插入可选内容：
立即学习“Java免费学习笔记（深入）”；
- 避免在
append()内写三元表达式拼接（如.append(flag ? "A" : "B")），易读性差且难以扩展 - 推荐把判断提前，再决定是否
append()—— 更清晰、易加日志或断点 - 多个枚举/状态时，用
switch分支追加不同后缀，比反复if-else更整洁
注意分隔符与边界处理（开头/结尾/重复）
常见痛点是逗号、换行、括号等分隔符位置出错。可用小技巧规避：
- 用
StringJoiner处理同类型列表（如参数名集合），再toString()后追加到StringBuilder - 对可能为空的字段，先收集非空值到
List<String>，再用String.join(", ", list)拼接，最后append() - 若需去除末尾多余分隔符（如循环后多了一个逗号），不建议用
deleteCharAt()—— 改用“先加再删”易出错；推荐在循环中判断是否首项，只在非首项前加逗号
避免常见陷阱：线程安全、容量、toString() 时机
StringBuilder 是非线程安全的，不要在多线程间共享实例；另外：
- 初始化时预估长度（如
new StringBuilder(256)），减少数组扩容开销 - 不要在循环内反复
new StringBuilder()然后toString()—— 若频繁创建，考虑复用对象（配合setLength(0)清空） -
toString()返回的是当前内容的副本，后续修改StringBuilder不影响已生成的字符串 —— 这是预期行为，但要注意别误以为是“实时引用”
