tostring方法应清晰、可读、稳定地反映对象核心状态，遵循类名{field=value}格式，仅包含关键业务字段并安全处理null与敏感信息，禁止副作用和外部依赖。
Java 中 toString 方法应清晰、可读、稳定地反映对象的核心状态，避免副作用、不依赖外部资源，并遵循通用约定（如类名 + 属性键值对）。
明确输出目的：只展示关键、稳定、可读的状态字段
不要打印日志、计算结果或临时变量；只包含构造后确定、业务上有意义的属性。例如一个 User 类，通常输出 id、name、email，而非 hashCode() 或懒加载的 profileImageBytes。
- 排除 null 值字段（除非 null 本身有业务含义）
- 敏感字段（如密码、token）必须脱敏或省略
- 集合类建议限制长度（如
list.subList(0, Math.min(3, list.size()))），避免 toString 爆栈或拖慢调试
格式统一：采用「类名{field=value, ...}」标准模板
这是 JDK 自带类（如 ArrayList、LocalDateTime）和主流框架（Spring、Lombok）默认采用的格式，开发者一眼可识别结构。
- 类名用
getClass().getSimpleName()，避免父类误报 - 字符串值加英文双引号（
"value"），null 显式写出（null） - 字段间用逗号+空格分隔，末尾不加逗号
- 示例：
User{id=123, name="Alice", email="alice@example.com"}
避免陷阱：不调用可能抛异常或触发副作用的方法
toString() 可能在日志、断点、JMX、序列化预览等不可控场景被频繁调用，必须保证安全。
- 禁止访问数据库、远程服务、文件系统
- 禁止调用可能抛
NullPointerException的 getter（先判空再拼接） - 禁止在
toString中修改对象状态（如自增计数器、清空缓存） - 若含递归引用（如父子关系），需加深度控制或标记已访问，防止 StackOverflowError
推荐实践：用 Lombok @ToString 或手动编写时复用 Objects.toStringHelper（Guava）
手写易出错且维护成本高；现代项目优先使用工具生成，同时保留定制能力。
- Lombok：
@ToString(includeFieldNames = true, of = {"id", "name", "email"})精确控制字段 - Guava：
Objects.toStringHelper(this).add("id", id).add("name", name).toString()，线程安全、自动 null 处理 - JDK 14+ 可考虑
Record，其默认toString已符合规范，无需额外实现
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
