stringbuilder扩容在count+新增字符数>value.length时立即触发，新容量按max(old×2+2, count+新增字符数)计算，本质是分配新数组、拷贝内容、更新引用三步操作。

StringBuilder 动态管理底层字符数组容量，核心在于 count（已用长度）和 value.length（底层数组容量）的实时比较，以及一次确定性的扩容决策流程，不是“用完再扩”，而是“要放不下就立刻换容器”。

扩容触发的真实条件

每次调用 append()、insert() 或 replace() 前，都会做一次容量校验：

• 计算所需最小容量：minimumCapacity = count + 新增字符数
• 只要 minimumCapacity > value.length，扩容立即发生
• 这个判断在操作执行前完成，不是等写入失败才处理
• 例如：默认构造的 StringBuilder，value.length == 16，count == 0；追加一个 20 字符字符串 → 0 + 20 > 16 → 触发扩容

新容量怎么算出来的

扩容不是简单翻倍，而是分两步取最大值：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 先按公式算基础容量：newCapacity = oldCapacity × 2 + 2（即 old ）
• 再与最小需求比对：最终容量 = max(newCapacity, minimumCapacity)
• 例如：当前容量 34，要追加 100 字符 → minimumCapacity = count + 100（假设 count 是 34）→ 需 134；34×2+2 = 70，70
• +2 的设计防止初始容量极小（如 1 或 2）时首次扩容仍不够用

扩容过程到底做了什么

每次扩容本质是三步内存操作，开销集中体现在第二步：

• 在堆上分配一块新数组（JDK 8 是 char[]，JDK 9+ 是 byte[]），长度为最终容量值
• 调用 System.arraycopy()，把旧数组中 count 个有效字符完整拷贝过去（时间复杂度 O(n)）
• 将内部 value 引用指向新数组，原数组失去引用，等待 GC 回收
• 频繁扩容会生成大量短命数组对象，推高年轻代 GC 频率

怎么让容量管理更高效

目标不是消灭扩容，而是让它少发生、准发生：

• 预估初始容量：比如拼接 100 条日志，每条平均 80 字符，加 10% 余量 → new StringBuilder(8800)
• 优先批量追加：append(String) 比循环多次 append(char) 更少触发边界检查和扩容判断
• 复用实例：在线程内或 ThreadLocal 中缓存 StringBuilder，避免反复 new 导致的 16 字节数组初始化开销
• 运行时观察：capacity() - length() 长期接近 0，说明预留不足；若 capacity() 远大于最终字符串长度，说明预估过大、浪费堆内存

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南