Java中toString推荐格式为“类名{字段1=值1, 字段2=值2, ...}”，类名不带包前缀，字符串加单引号，null显式写出，建议用Objects.toString安全处理null，避免副作用与复杂计算，推荐IDE自动生成或Lombok@ToString统一管理。
Java 中 toString 方法的输出格式没有强制标准，但行业普遍采用清晰、一致、可读性强的结构化形式，目的是让日志、调试和集合打印时一眼看懂对象状态。
类名 + 括号包裹的键值对
推荐格式为：类名{字段1=值1, 字段2=值2, ...}。例如 Person{name='Alice', age=25, email=null}。这种写法符合多数 IDE 自动生成模板（如 IntelliJ、VSCode）的默认风格，也与 Apache Commons Lang 的 ToStringBuilder 输出一致。
- 类名用实际类名，不带包前缀（避免冗长，如
Person而非com.example.Person） - 字段名与值之间用
=连接，字符串值加单引号，数值/布尔值不加引号 - null 值显式写出（如
email=null），比跳过更利于排查空指针问题 - 字段顺序建议按声明顺序或业务重要性排列，保持团队内统一
避免拼接错误与空指针风险
手动拼接时容易遗漏 null 判断，导致运行时异常。例如直接写 name + ", " + email 在 name 为 null 时会变成 "null, xxx@xxx.com"，虽不崩溃但语义失真；若用 name.length() 则直接抛 NullPointerException。
- 对可能为 null 的引用类型字段，用
Objects.toString(field, "null")安全转换 - 避免在 toString 中调用可能抛异常或触发副作用的方法（如远程调用、数据库查询）
- 不建议在 toString 中做复杂计算或格式化（如日期转本地时区），应由调用方控制
配合工具链提升一致性
靠人工维护易出错，推荐借助开发工具自动生成并约束格式：
立即学习“Java免费学习笔记（深入）”；
- IDEA 或 VSCode 安装 Java 插件后，右键 → Generate → toString，选择 Lombok、Commons Lang 或内置模板
- 使用 Lombok 的
@ToString注解，支持 exclude、include、callSuper 等参数精细控制 - 团队可统一配置
java.codeGeneration.toStringTemplate（VSCode）或Settings → Editor → Code Style → Java → Wrapping and Braces → toString()（IDEA）
数组与嵌套对象的连贯处理
当对象包含数组或关联其他自定义对象时，toString 应延续可读逻辑：
- 一维数组优先用
Arrays.toString(arr)，它自动加方括号、逗号分隔 - 二维及以上数组用
Arrays.deepToString(arr)，避免出现[[I@7a81197d]这类哈希码 - 关联对象若已重写 toString，直接拼接即可；若未重写，考虑临时委托或简化显示（如
address=Address@xxxx改为addressId=1024）
