Java中toString方法的核心目标是提供可读、稳定、无副作用的调试信息，应优先使用StringBuilder手动拼接、Objects.toString()处理null、避免副作用操作，并可借助Lombok@ToString或record简化实现。
Java 中 toString 方法的核心目标是提供**可读、稳定、无副作用**的调试信息，而非追求极致性能。高效拼接的关键在于避免运行时开销、减少对象创建，并保持逻辑清晰。
优先使用 StringBuilder 手动拼接
字符串拼接在 toString 中频繁发生，但直接用 + 操作符在循环或多个字段场景下会隐式创建多个 StringBuilder 实例，带来额外开销。手动复用 StringBuilder 更可控：
- 初始化容量（如
new StringBuilder(128)）可减少扩容次数 - 链式调用
.append()避免中间字符串对象生成 - 对 null 字段显式处理（如
s == null ? "null" : s），防止 NPE
示例：
public String toString() {
return new StringBuilder(128)
.append("User{id=")
.append(id)
.append(", name='")
.append(name == null ? "null" : name)
.append("', age=")
.append(age)
.append('}')
.toString();
}
利用 Objects.toString() 统一处理 null
对于每个可能为 null 的字段，手写三元判断易出错且冗长。JDK 提供的 Objects.toString(Object, String) 可简化逻辑：
立即学习“Java免费学习笔记（深入）”；
-
Objects.toString(name, "null")等价于name == null ? "null" : name.toString() - 配合
StringBuilder使用，语义清晰，不易遗漏 - 比自定义工具方法更轻量，无需额外依赖
避免在 toString 中触发副作用或耗时操作
toString 常被日志、调试器、IDE 自动调用，一旦包含业务逻辑，极易引发问题：
- 不要调用数据库查询、远程接口、文件读取等 I/O 操作
- 避免调用可能修改状态的方法（如
computeXXX()） - 不建议懒加载字段（如未初始化的集合）再在
toString中初始化——这会让调试行为改变程序状态
考虑使用 Lombok 或 Record 简化模板代码
若项目允许引入注解处理器，Lombok 的 @ToString 是成熟选择：
- 默认排除敏感字段（如密码）、循环引用字段（如 parent/children）
- 支持
includeFieldNames = true输出键值对格式，提升可读性 - 比手写更少出错，且编译期生成，零运行时开销
Java 14+ 的 record 类自动提供结构清晰、不可变的 toString，适合数据载体类：
public record Point(int x, int y) {} // toString 返回 "Point[x=1, y=2]" 
