stringbuilder支持链式调用，因其修改方法均返回this；应一气呵成调用并最后tostring()，避免中途赋值、混用tostring()或共享实例导致线程不安全。
StringBuilder 本身支持链式调用，因为它的所有修改方法（如 append、insert、delete 等）都返回 this（即当前 StringBuilder 实例），这天然契合流式编程风格。关键在于避免中途赋值打断链式，同时合理组织逻辑顺序。
保持方法调用连续，不中断返回值
链式调用的核心是让每个方法都作用于同一个对象，并把结果继续传递下去。不要在中间用变量接收或拆成多行赋值：
// ❌ 打断链式：赋值后丢失上下文
StringBuilder sb = new StringBuilder();
sb.append("Hello");
sb.append(" ");
sb.append("World"); // 最终要靠 sb.toString() 获取，但过程不“流式”
// ✅ 真正流式：一气呵成，最后才取结果
String result = new StringBuilder()
.append("Hello")
.append(" ")
.append("World")
.toString(); // 只在终点调用 toString()
组合多个操作时注意执行顺序和可读性
StringBuilder 的方法是按调用顺序依次执行的，适合表达“先…再…然后…”的构建逻辑。例如拼接带格式的 SQL 片段：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
String sql = new StringBuilder("SELECT ")
.append("id, name, email")
.append(" FROM users")
.append(" WHERE status = 'active'")
.append(" ORDER BY created_at DESC")
.toString();
这种写法比字符串拼接更高效，也比反复调用 sb.append(...) 更紧凑清晰。
配合三元判断或条件拼接（需谨慎）
纯链式难以嵌入分支逻辑，但可通过提取条件表达式 + 单行 append 维持流畅性：
- 用三元运算符生成待拼内容（推荐用于简单判断）
- 用
if块外构建 StringBuilder，内部只做 append（适合复杂分支）
// ✅ 简单条件：用三元保持链式
String msg = new StringBuilder("User ")
.append(userId)
.append(" is ")
.append(isActive ? "active" : "inactive")
.append(".")
.toString();
// ✅ 复杂条件：先建实例，再分段 append（仍属流式思维）
StringBuilder log = new StringBuilder("Processing order #").append(orderId);
if (isUrgent) log.append(" [URGENT]");
if (hasDiscount) log.append(" (discount applied)");
log.append(" at ").append(LocalDateTime.now());
String finalLog = log.toString();
避免常见陷阱
-
不要在链中混用 toString()：一旦调用
toString()就终止链，后续方法会报错（因为返回的是 String，不是 StringBuilder） - 线程不安全：流式写法常用于局部变量，无需考虑并发；若误在多线程共享 StringBuilder 上链式调用，会出问题
- 过度链式降低可读性：超过 5–6 步时，适当换行 + 注释，或拆成逻辑块更利于维护
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
