StringBuilder支持链式调用，因其修改方法均返回this；toString()为终结操作不可续链，需注意避免使用void或基本类型返回值的方法中断链式。
Java 中 StringBuilder 天然支持链式调用，因为它的所有修改方法（如 append()、insert()、delete() 等）都返回 this（即当前对象引用）。合理利用这一点，能写出更紧凑、可读性更高、副作用更少的字符串构建逻辑。
理解链式调用的核心前提
链式调用成立的关键是：方法必须返回当前对象（StringBuilder 实例本身），而非 void 或新对象。所有标准的“变更状态”方法都满足这点，例如：
-
append(...)→ 返回this -
insert(int, ...)→ 返回this -
delete(int, int)→ 返回this -
replace(int, int, String)→ 返回this -
reverse()→ 返回this
注意：toString() 是终结操作，它返回 String，**不可再链式调用**；若需继续操作，应保留原始 StringBuilder 引用或重新赋值。
典型场景下的链式写法示例
✅ 构建带格式的 SQL 插入语句：
立即学习“Java免费学习笔记（深入）”；
String sql = new StringBuilder("INSERT INTO users (name, age, city)")
.append(" VALUES (")
.append("'").append(name).append("'")
.append(", ").append(age)
.append(", '").append(city).append("'")
.append(");")
.toString();
✅ 清洗并标准化手机号（去空格、去短横、补前缀）：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
String normalized = new StringBuilder(phone)
.replace(0, 0, "") // 确保从头开始（可选）
.deleteCharAt(0) // 假设要去掉开头的 '0'
.replaceAll("-", "") // 注意：replaceAll 是 String 方法，不能直接链在 StringBuilder 上
.insert(0, "86") // 所以改用 delete/insert 组合
.toString();
⚠️ 提示：replaceAll 不在 StringBuilder 中，需先转 String 再处理，或用 delete()+insert() 模拟。更推荐分步或封装为工具方法。
避免常见陷阱
❌ 错误：对同一个 StringBuilder 实例做多次无意义的链式调用，却忽略中间状态被覆盖：
String s = new StringBuilder().append("a").append("b").append("c").toString();
// 正确：一次构建完成
String t = new StringBuilder().append("x").toString().length(); // ❌ 编译失败！toString() 后无法 append
❌ 错误：误以为 setCharAt() 或 capacity() 支持链式 —— 它们返回 void 或基本类型，会中断链：
-
setCharAt(i, c)→void，不能链 -
capacity()/length()→int，不能链 -
ensureCapacity(n)→void，不能链（但通常不需要显式调用）
进阶技巧：配合 lambda 或静态工具方法增强可读性
当逻辑较复杂时，可封装为静态方法，保持链式外观：
public static StringBuilder withPrefix(StringBuilder sb, String prefix) {
return sb.insert(0, prefix);
}
public static StringBuilder trimAndWrap(StringBuilder sb, String wrapper) {
return sb.delete(0, sb.length()).append(wrapper).append(sb.toString()).append(wrapper);
}
// 使用：
String result = withPrefix(new StringBuilder("hello"), "[")
.append("]")
.toString(); // → "[hello]"
这样既维持了链式风格，又把语义抽象出来，便于复用和测试。
链式调用不是炫技，而是让意图更聚焦于“构建什么”，而不是“怎么一步步改”。只要记住返回 this 的方法才能续链，避开终结操作和非返回型方法，就能写出干净利落的 StringBuilder 代码。
