String.contentEquals() 是 Java 中专为跨类型字符序列内容比对设计的高效方法，可直接比较 String 与 StringBuilder（或 StringBuffer、CharBuffer 等）是否具有完全相同的字符序列，避免 toString() 创建临时对象，且语义清晰、性能稳定。
`string.contentequals()` 是 java 中专为跨类型字符序列内容比对设计的高效方法，可直接比较 string 与 stringbuilder（或 stringbuffer、charbuffer 等）是否具有完全相同的字符序列，避免 `tostring()` 创建临时对象，且语义清晰、性能稳定。
在 Java 字符串处理中，当需要判断一个 String 是否与动态构建的 StringBuilder（如旋转字符串、拼接中间态等场景）内容完全一致时，切忌使用 == 或 sb.toString().equals(str) ——前者比较引用必然失败（除非巧合指向同一常量池对象），后者虽逻辑正确但会触发不必要的对象创建，带来内存开销与 GC 压力。
正确的做法是使用 String.contentEquals(CharSequence) 方法。该方法定义于 String 类，接收任意 CharSequence 实现类（包括 StringBuilder、StringBuffer、String、CharBuffer 等），内部采用逐字符遍历比对（O(n) 时间复杂度，O(1) 空间复杂度），不依赖 equals() 重写逻辑，也不生成新字符串对象。
✅ 推荐用法示例：
String str = "cdeab";
StringBuilder sb = new StringBuilder("abcde");
// 模拟一次左旋：将首字符移到末尾 → "bcdea"
sb.append(sb.charAt(0)).deleteCharAt(0); // "bcdea"
sb.append(sb.charAt(0)).deleteCharAt(0); // "cdeab"
// 安全、高效、无副作用的内容比对
boolean isEqual = str.contentEquals(sb); // true
⚠️ 使用注意事项：
-
调用主体必须是
String：str.contentEquals(sb)合法；sb.contentEquals(str)编译报错（StringBuilder无此方法）； -
需显式判空：若
sb或str为null，调用contentEquals()将抛出NullPointerException，建议前置校验：if (str != null && sb != null && str.contentEquals(sb)) { ... } -
严格区分大小写：
contentEquals()不支持忽略大小写的比较。如需忽略大小写，可统一转为小写后比对：str.toLowerCase().contentEquals(sb.toString().toLowerCase()); // 注意：此处 toString() 开销可控，因仅用于大小写转换 // 更优解：手动遍历并忽略大小写（适用于高频/大文本场景）
-
不适用于
StringBuilder与StringBuffer互比：二者均未提供跨类型contentEquals，需统一转为String或借助toString().contentEquals(...)（注意对象创建成本）。
? 对比常见错误写法：
| 写法 | 问题 |
|------|------|
| sb.toString() == str | 引用比较，永远为 false（除非 sb.toString() 返回常量池中已有字符串，极罕见） |
| sb.toString().equals(str) | 功能正确，但每次调用都新建 String 对象，对长字符串或循环调用（如旋转检测）显著影响性能 |
| sb.equals(str) | StringBuilder 继承自 Object，equals() 比较的是对象引用，恒为 false |
? 总结：String.contentEquals() 是处理 String 与可变字符序列内容一致性问题的首选方案——它兼顾安全性（语义明确）、效率（零对象分配）与简洁性（一行代码解决）。在实现字符串旋转、模板填充、流式解析等需频繁比对中间状态的场景中，应作为标准实践推广。
