stringbuilder 是 java 中高效拼接字符串的可变序列类,append() 支持多类型链式追加且返回自身,length() 返回当前字符数而非容量,二者常配合用于动态构建与长度控制,最终需调用 tostring() 获取 string。

StringBuilder 是 Java 中用于高效拼接和修改字符串的可变字符序列类。它不产生大量临时对象,比 String 拼接更省内存、更快速。其中 append() 和 length() 是最常使用的两个方法,理解它们的行为和配合方式,是写出清晰、高效字符串操作代码的基础。
append():支持多类型追加,返回自身实现链式调用
append() 方法把任意类型的数据(String、int、double、char、boolean 甚至 null)转成字符串后,追加到当前 StringBuilder 的末尾。关键点在于:它总是返回 this,也就是当前 StringBuilder 对象本身,因此支持连续调用(链式写法)。
- 支持所有基本类型和引用类型,自动调用 toString()(null 会变成字符串 "null")
- 不会创建新对象,直接在内部 char 数组上扩展内容
- 如果内部数组容量不足,会自动扩容(默认初始容量为 16,扩容策略为原容量 ×2 +2)
示例:
StringBuilder sb = new StringBuilder();
sb.append("Java").append(8).append(true).append('!');
// 结果是 "Java8true!",全程只操作一个对象
length():返回当前字符个数,不是容量也不是地址
length() 返回的是当前 StringBuilder 中实际存储的字符数量,即“有效内容长度”。它和容量(capacity)不同——capacity 表示底层 char 数组能容纳多少字符而不触发扩容,而 length 只关心已填入多少。
- 初始空对象的 length 为 0;append 后 length 随之增加
- 调用 delete()、deleteCharAt() 或 setLength() 会改变 length
- length() 值永远 ≤ capacity(),但两者没有固定比例关系
示例:
StringBuilder sb = new StringBuilder("abc");
System.out.println(sb.length()); // 输出 3
sb.append("def");
System.out.println(sb.length()); // 输出 6
append 和 length 的典型配合场景
这两个方法常一起用于动态构建字符串并实时判断状态,比如日志拼接、SQL 拼装、JSON 字段组装等。
- 拼接前检查长度,避免超长(如限制 SQL 字符串总长)
- 循环中反复 append,用 length 判断是否达到阈值需截断或分批
- 结合 reverse() 或 substring() 前,先用 length() 获取边界位置
- 调试时打印 sb.length() 辅助确认数据是否按预期写入
注意 toString() 才能得到最终字符串
StringBuilder 本身不是 String,不能直接用于需要 String 的地方(如 Map 键、文件写入、网络传输)。必须显式调用 toString() 转换。这个操作会创建一个新的 String 对象,内容是当前 StringBuilder 的快照。
- 多次 toString() 不影响 StringBuilder 本身
- 后续 append 不会改变已生成的 String
- 不要在循环内频繁 toString(),否则抵消了 StringBuilder 的性能优势
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











