直接调用 StringBuilder.setLength(0) 是最轻量的重置方式,它不释放底层 char 数组,仅将长度计数器归零,后续 append() 从索引 0 覆盖写入,避免重复分配和构造开销。

直接调用 StringBuilder.setLength(0) 是重置 StringBuilder 的最轻量方式,它不释放底层 char 数组,仅将内部长度计数器归零,后续追加操作会覆盖旧内容——这正是内存复用的核心机制。
为什么 setLength(0) 比 new StringBuilder() 更高效
新建 StringBuilder 会分配新数组(默认容量 16),若频繁创建,易触发多次内存分配与 GC;而 setLength(0) 复用已有数组,避免重复分配和对象创建开销。尤其在循环中反复拼接字符串时,性能差异明显。
- 底层 char[] 保留不变,仅修改
count = 0 - 后续
append()从索引 0 开始写入,自动覆盖旧数据 - 无需重新初始化对象,无构造函数开销
正确使用 setLength(0) 的关键细节
必须确保 StringBuilder 实例被合理复用,且调用时机明确。常见误用是重置后未检查容量是否足够,导致隐式扩容。
- 首次初始化时可预估最大长度,例如
new StringBuilder(1024),减少扩容概率 - 重置后若追加内容可能超当前容量,
append()仍会自动扩容——这不是 setLength(0) 的问题,而是容量管理需前置规划 - 不要混用
delete(0, length())或replace(0, length(), ""),它们逻辑更重、效率更低
典型复用场景示例
比如日志拼接、CSV 行生成、SQL 参数组装等固定模板+变量填充的循环任务:
StringBuilder buf = new StringBuilder(256);
for (Record r : records) {
buf.setLength(0); // 快速清空,复用内存
buf.append("id=").append(r.id())
.append(",name='").append(r.name()).append("'");
log(buf.toString());
}
该写法比每次 new StringBuilder 节省 90% 以上临时对象创建开销(实测 JDK 17 下)。
注意边界情况
setLength(0) 安全,但若曾调用过 toString(),需留意其返回的 String 可能持有对原 char[] 的引用(JDK 7u6 以后已修复,String 构造时会复制数组)。现代 JDK 中无需担心泄漏,但仍建议:若 StringBuilder 生命周期很长且拼接内容差异极大,可定期评估是否需手动缩小容量(trimToSize()),不过多数场景不必。

















