Java StringBuilder 实现原理全攻略
更新时间：2025年09月16日 15:15:54 作者：北辰alk
StringBuilder 是 Java 提供的可变字符序列类,位于 java.lang 包中,专门用于高效处理字符串的拼接和修改操作,本文给大家介绍Java StringBuilder 实现原理深度解析,感兴趣的朋友跟随小编一起看看吧
一、StringBuilder 基本概述
StringBuilder 是 Java 提供的可变字符序列类，位于 java.lang 包中，专门用于高效处理字符串的拼接和修改操作。与不可变的 String 类相比，StringBuilder 提供了更优的性能表现，特别是在频繁修改字符串的场景下。
核心特性
- 可变性：内部字符数组可动态扩展
- 非线程安全：相比 StringBuffer 有更好的性能
- 高效操作：避免创建大量临时 String 对象
二、StringBuilder 核心实现
2.1 内部数据结构
StringBuilder 的核心是一个可变的字符数组（char[]）：
// JDK 17 中的实现
abstract class AbstractStringBuilder {
byte[] value; // Java 9 后改为byte[]以支持紧凑字符串
int count; // 实际使用的字符数
boolean isLatin1; // 是否Latin-1编码
}Java 9 重大变化：为了减少内存占用，JDK 9 将内部实现从
char[]改为byte[]，并引入编码标志位来支持紧凑字符串（Compact Strings）特性。
2.2 初始化机制
StringBuilder 提供多种构造方法：
// 默认构造器（初始容量16）
StringBuilder sb1 = new StringBuilder();
// 指定初始容量
StringBuilder sb2 = new StringBuilder(100);
// 基于字符串初始化
StringBuilder sb3 = new StringBuilder("Hello");初始化时内部数组大小计算：
- 默认构造器：16字符
- 指定容量：使用指定值
- 字符串初始化：字符串长度 + 16
2.3 自动扩容机制
当追加内容超过当前容量时，StringBuilder 会自动扩容：
private void ensureCapacityInternal(int minimumCapacity) {
if (minimumCapacity - value.length > 0) {
value = Arrays.copyOf(value, newCapacity(minimumCapacity));
}
}
private int newCapacity(int minCapacity) {
int newCapacity = (value.length << 1) + 2; // 通常扩容为原大小2倍+2
if (newCapacity - minCapacity < 0) {
newCapacity = minCapacity;
}
return (newCapacity <= 0 || MAX_ARRAY_SIZE - newCapacity < 0)
? hugeCapacity(minCapacity)
: newCapacity;
}扩容策略：
- 新容量 = (原容量 × 2) + 2
- 如果仍不足，则直接扩容到所需大小
- 最大容量为 Integer.MAX_VALUE - 8
三、关键操作实现原理
3.1 append() 方法实现
append() 是 StringBuilder 最常用的方法，支持多种数据类型：
public StringBuilder append(String str) {
super.append(str);
return this;
}
// 父类 AbstractStringBuilder 中的实现
public AbstractStringBuilder append(String str) {
if (str == null) {
return appendNull();
}
int len = str.length();
ensureCapacityInternal(count + len);
putStringAt(count, str);
count += len;
return this;
}执行流程：
- 检查容量是否足够
- 将新内容拷贝到字符数组
- 更新字符计数
3.2 insert() 方法实现
public StringBuilder insert(int offset, String str) {
super.insert(offset, str);
return this;
}
// 父类实现
public AbstractStringBuilder insert(int offset, String str) {
if ((offset < 0) || (offset > length()))
throw new StringIndexOutOfBoundsException(offset);
if (str == null)
str = "null";
int len = str.length();
ensureCapacityInternal(count + len);
shift(offset, len); // 移动现有字符
putStringAt(offset, str);
count += len;
return this;
}特点：
- 需要移动现有字符为新内容腾出空间
- 性能比 append() 差，特别是插入位置靠前时
3.3 delete() 方法实现
public StringBuilder delete(int start, int end) {
super.delete(start, end);
return this;
}
// 父类实现
public AbstractStringBuilder delete(int start, int end) {
int count = this.count;
if (end > count)
end = count;
if (start > end)
throw new StringIndexOutOfBoundsException();
int len = end - start;
if (len > 0) {
shift(end, -len); // 向左移动字符
count -= len;
}
return this;
}四、性能优化分析
4.1 与 String 拼接的对比
String 拼接示例：
String result = "";
for (int i = 0; i < 10000; i++) {
result += i; // 每次循环创建新String对象
}
StringBuilder 优化：
StringBuilder sb = new StringBuilder();
for (int i = 0; i < 10000; i++) {
sb.append(i); // 仅操作内部数组
}
String result = sb.toString();
性能差异：
- String 拼接：O(n²) 时间复杂度
- StringBuilder：O(n) 时间复杂度
4.2 初始容量优化
合理设置初始容量可避免多次扩容：
// 预估最终字符串长度约为2000字符 StringBuilder sb = new StringBuilder(2000);
扩容代价：
- 分配新数组
- 拷贝原有内容
- 丢弃旧数组（增加GC压力）
4.3 Java 9 后的紧凑字符串优化
JDK 9 引入的紧凑字符串特性使 StringBuilder 更高效：
- Latin-1 字符使用1字节存储
- UTF-16 字符使用2字节存储
- 自动检测和转换编码
五、线程安全性考虑
StringBuilder 是非线程安全的实现，而 StringBuffer 是线程安全的版本：
// StringBuilder 的典型方法（无同步）
public StringBuilder append(String str) {
super.append(str);
return this;
}
// StringBuffer 的对应方法（有同步锁）
public synchronized StringBuffer append(String str) {
toStringCache = null;
super.append(str);
return this;
}选择建议：
- 单线程环境：优先使用 StringBuilder（性能更优）
- 多线程环境：使用 StringBuffer 或外部同步
六、特殊方法解析
6.1 reverse() 实现
public StringBuilder reverse() {
super.reverse();
return this;
}
// 父类实现
public AbstractStringBuilder reverse() {
boolean hasSurrogate = false;
int n = count - 1;
for (int j = (n-1) >> 1; j >= 0; j--) {
char temp = value[j];
char temp2 = value[n - j];
if (!hasSurrogate) {
hasSurrogate = (temp >= Character.MIN_SURROGATE &&
temp <= Character.MAX_SURROGATE) ||
(temp2 >= Character.MIN_SURROGATE &&
temp2 <= Character.MAX_SURROGATE);
}
value[j] = temp2;
value[n - j] = temp;
}
if (hasSurrogate) {
reverseAllValidSurrogatePairs();
}
return this;
}特点：
- 处理了Unicode代理对（surrogate pairs）
- 原地反转，不创建新数组
6.2 setLength() 实现
public void setLength(int newLength) {
if (newLength < 0)
throw new StringIndexOutOfBoundsException(newLength);
ensureCapacityInternal(newLength);
if (count < newLength) {
// 填充空字符
Arrays.fill(value, count, newLength, '\0');
}
count = newLength;
}用途：
- 截断字符串（newLength < count）
- 扩展字符串（newLength > count）
七、与StringBuffer的关系
StringBuilder 和 StringBuffer 都继承自 AbstractStringBuilder：
设计差异：
- StringBuffer 方法添加了 synchronized 关键字
- StringBuffer 有 toStringCache 字段优化多次 toString() 调用
- StringBuilder 自 JDK 5 引入，作为 StringBuffer 的非线程安全替代
八、最佳实践
循环拼接字符串必用 StringBuilder：
// 错误示范
String result = "";
for (String part : parts) {
result += part;
}
// 正确做法
StringBuilder sb = new StringBuilder();
for (String part : parts) {
sb.append(part);
}
String result = sb.toString();预估大小减少扩容：
// 已知大约需要200字符空间 StringBuilder sb = new StringBuilder(200);
链式调用：
String result = new StringBuilder()
.append("Name: ").append(name)
.append(", Age: ").append(age)
.toString();
局部使用优于成员变量：
// 每个方法内创建独立的StringBuilder
void process() {
StringBuilder sb = new StringBuilder();
// 使用sb
}
复杂格式化考虑 String.format()：
// 简单情况
String message = String.format("User %s (ID: %d) logged in", name, id);
// 非常复杂的格式化仍可用StringBuilder九、现代Java中的变化
JDK 9+ 的改进
- 紧凑字符串（Compact Strings）：
- 内部存储从 char[] 改为 byte[]
- 根据内容自动选择 Latin-1 或 UTF-16 编码
- 显著减少内存占用
- 字符串拼接优化：
- 现代Java编译器会将某些 String 拼接自动优化为 StringBuilder 操作
JDK 15 的文本块（Text Blocks）
虽然与 StringBuilder 无直接关系，但文本块减少了复杂字符串构建的需求：
// 传统方式
String html = new StringBuilder()
.append("<html>\n")
.append(" <body>\n")
.append(" <p>Hello</p>\n")
.append(" </body>\n")
.append("</html>")
.toString();
// JDK 15+
String html = """
<html>
<body>
<p>Hello</p>
</body>
</html>""";十、总结
StringBuilder 的核心价值在于：
- 高效的内存使用：通过可变字符数组避免大量临时对象
- 优秀的性能表现：O(n) 复杂度的字符串操作
- 灵活的API设计：支持链式调用和各种数据类型
- 与时俱进：Java 9 的紧凑字符串进一步提升了效率
理解其实现原理有助于：
- 编写更高效的字符串处理代码
- 在合适的场景选择最佳工具
- 诊断字符串相关的性能问题
- 深入理解Java集合和数组的设计思想
到此这篇关于Java StringBuilder 实现原理全攻略的文章就介绍到这了,更多相关Java StringBuilder 原理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要为大家详细介绍了java实现微信公众号扫一扫，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-04-04
Java中Stringbuild,Date和Calendar类的用法详解
这篇文章主要为大家详细介绍了Java中Stringbuild、Date和Calendar类的用法，文中的示例代码讲解详细，感兴趣的小伙伴可以跟随小编一起了解一下2023-04-04
这篇文章主要介绍了nacos配置注册中心时指定命名空间不起作用的问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教。2022-01-01
调用Mybatis plus中的saveBatch方法报找不到表的问题
在用Mybatis plus开发的项目中，用自带的API批量保存的方法saveBatch操作时，发现报没有找到表的错误，本文就来详细的介绍一下解决方法，感兴趣的可以了解一下2024-03-03
Java list与set中contains()方法效率案例详解
这篇文章主要介绍了Java list与set中contains()方法效率案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下2021-08-08
使用java springboot设计实现的图书管理系统（建议收藏）
这篇文章主要介绍了使用java springboot设计实现的图书管理系统，包含了整个的开发过程，以及过程中遇到的问题和解决方法，对大家的学习和工作具有借鉴意义，建议收藏一下2021-08-08
这篇文章主要给大家介绍了关于java批量导入Excel数据的相关资料,EXCEL导入就是文件导入,操作代码是一样的,文中给出了详细的代码示例,需要的朋友可以参考下2023-08-08
今天小编就为大家分享一篇java 判断字符串中是否有重复字符的示例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-07-07
Spring Boot自动配置是其核心特性之一,极大地简化了Spring应用的开发过程,这篇文章主要介绍了JAVA进阶之Spring Boot自动配置示例详解的相关资料,需要的朋友可以参考下2026-01-01
这篇文章主要介绍了Java 集合系列（三）—— LinkedList，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-04-04
最新评论