stringbuilder的insert方法用于在指定索引位置插入内容,支持多种数据类型重载和链式调用,而append仅在末尾追加;insert索引范围为[0, length],越界抛异常,insert(length, str)等价于append。

StringBuilder 的插入(insert)和追加(append)方法看似相似,但用途和行为有本质区别:append 总是在末尾添加,而 insert 可以在任意位置插入内容——这是控制字符串结构的关键能力。
insert 方法:精准控制插入位置
insert(int offset, String str) 将字符串插入到指定索引位置,原内容自动后移。注意:offset 必须在 [0, 当前长度] 范围内,越界会抛出 StringIndexOutOfBoundsException。
- 索引从 0 开始,insert(0, "x") 表示开头插入;insert(sb.length(), "y") 等价于 append
- 支持多种重载形式,如 insert(int, char)、insert(int, int)、insert(int, Object),底层都会调用对应类型的 toString()
- 多次 insert 时要注意索引动态变化,例如:sb.insert(0, "A").insert(0, "B") 结果是 "BA" + 原内容,而非 "AB"
append 方法:高效拼接,专注末尾扩展
append 是最常用的操作,直接在当前字符串末尾追加内容,返回自身(支持链式调用),性能优于字符串拼接(+)。
- append(null) 会插入字符串 "null",不是空指针异常
- append(char[])、append(CharSequence)、append(double) 等重载让类型适配更灵活
- 连续 append 多个值时,推荐链式写法:sb.append("name:").append(name).append(", age:").append(age)
insert 和 append 的协同使用场景
实际开发中常需组合使用:比如格式化日志、构造 SQL 片段、生成带分隔符的列表。
- 构建带前缀的编号字符串:先 append 基础编号,再 insert(0, "ID-")
- 向中间插入分隔符:对逗号分隔的字符串,用 insert 在每两个字符间插 ","(需倒序处理避免索引偏移)
- 模板填充:先 append 模板头,再 insert 指定位置填入变量,最后 append 模板尾
性能与线程安全提醒
StringBuilder 是非线程安全的,但正因如此,它比 StringBuffer 更快;insert 和 append 都是 O(n) 时间复杂度(涉及数组扩容或元素移动),但日常使用无需过度优化。
- 初始化容量可减少扩容次数:new StringBuilder(128) 适合预估长度的场景
- 避免在循环内反复 insert(0, ...),这会导致每次操作都移动全部字符,效率低下
- 若需频繁首部插入,考虑用 LinkedList
收集再 join,或改用 StringJoiner
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











