stringbuilder无直接设置容量的api，需通过构造方法预设初始容量（如new stringbuilder(200)），capacity()返回当前底层数组长度，扩容由append触发且开销大，不可运行时修改容量。

StringBuilder 本身不提供直接设置或获取内部字符数组（缓冲区）容量的公开 API，但可以通过构造方法预设初始容量，并用 capacity() 方法读取当前实际容量。动态扩容开销主要来自底层数组复制，合理预估并设置初始容量是减少扩容的关键。

如何设置初始容量（构造时指定）

在创建 StringBuilder 实例时，通过带 int capacity 参数的构造方法，可预先分配足够大的内部字符数组，避免后续多次扩容：

• new StringBuilder(64)：内部 char 数组初始长度为 64
• new StringBuilder("hello")：初始容量 = "hello".length() + 16（默认 16 的增量）
• 若已知最终字符串长度约 200 字符，推荐写 new StringBuilder(200)，而非依赖默认扩容逻辑

如何获取当前缓冲区容量

调用 capacity() 方法即可返回当前内部 char 数组的长度（即已分配但未必全部使用的空间大小）：

Alibabacloud Sdk Client Initialization For Java

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

下载

• StringBuilder sb = new StringBuilder(32); System.out.println(sb.capacity()); // 输出 32
• sb.append("a".repeat(50)); System.out.println(sb.capacity()); // 可能变为 64 或更大（触发扩容后）
• 注意：capacity() ≠ length()；length() 是当前有效字符数，capacity() 是底层数组总长度

扩容机制与优化建议

当 append 等操作导致字符数超过当前容量时，StringBuilder 会自动扩容：新容量 ≈ oldCapacity * 2 + 2（JDK 8+ 实现），然后复制原数组内容。频繁扩容会带来明显性能损耗。

• 对确定长度的场景（如拼接固定数量的字段），优先用预设容量构造，例如 new StringBuilder(128)
• 对不确定长度但有上限的场景（如日志拼接最多 512 字符），按上限设初始容量
• 避免反复创建小容量 StringBuilder 后大量追加；也无需过度预留（如设 10000 容量只写 10 字符），浪费内存

不能直接修改已有实例的 capacity

Java 不允许运行时调整 StringBuilder 内部数组大小。没有类似 setCapacity(int) 的 public 方法（虽然 JDK 内部有 package-private 的 expandCapacity，但不可调用）。

• 如需“重置”容量，只能新建一个：例如 sb = new StringBuilder(sb.toString())，但这会丢失原有引用且开销较大
• 更实用的做法是：在明确知道后续操作规模时，一开始就选对初始容量，而不是事后调整

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