预设 stringbuilder 初始容量的核心是避免扩容,需满足 length() + 新增字符数 ≤ capacity();应按总长加连接符、模板字符及 10%~15% 余量估算,并向上取整至 2 的幂;循环中复用实例并调用 setlength(0),慎用 ensurecapacity。

预设 StringBuilder 初始容量的核心,是让 length() + 新增字符数 ≤ capacity() 成立,从而在 append 过程中不触发扩容。这不是“锦上添花”,而是避免 System.arraycopy 拷贝、减少 GC 压力的刚性要求。
按拼接内容总长加余量初始化
先算出所有待拼字符串长度之和,再加连接符、换行符、模板固定字符等额外开销,最后加 10%~15% 波动余量:
- 拼集合:遍历 List
累加每个 str.length(),再加分隔符(如逗号+空格共 2 字节 × (size−1)) - 拼模板:例如 "[{}][{}] {}",前缀 12 字 + 用户 ID 最长 32 字 + 方法名最长 64 字 + 消息体预估 512 字 = 617,加 10% → 设为
new StringBuilder(680) - 向上取整到最近的 2 的幂更友好(如 950 → 1024),部分 JVM 对内存对齐有优化
复用实例时优先 setLength(0),别新建
在循环或高频调用中,StringBuilder 实例应在作用域外创建,全程复用:
- ✅ 正确:方法开头
StringBuilder sb = new StringBuilder(2000);,循环内sb.setLength(0); sb.append(...); - ❌ 错误:每次循环都
new StringBuilder(),等于放弃所有优化,还增加 GC 负担 -
setLength(0)只重置计数器,不释放数组,比新建快得多;toString()后可继续复用
根据典型场景选择合理容量档位
不同用途有经验参考值,不必每次精算,但要跳出默认 16:
- 日志拼接:固定前缀约 40 字 + 方法名平均 30 字 + 消息体预估 100 字 → 初始设 200~300
- JSON/XML 生成:1000 条记录 × 平均 120 字 + 结构符号 ≈ 125000 →
new StringBuilder(130000) - 单条消息上限明确(如 ≤ 8KB)→ 直接设
new StringBuilder(8192),基本免扩容
慎用 ensureCapacity,它只是兜底
ensureCapacity(minCapacity) 能动态补足,但已发生的扩容无法撤销,且调用本身有判断开销:
- 适合不确定总长但有上限的场景(如用户输入字段拼接),提前设个安全值更稳
- 不要依赖它替代预估——“自动扩容”不是优化策略,而是容错机制
- 注意:传入负数会抛 IllegalArgumentException;0 是合法值,但首次 append 仍要扩容
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











