String.valueOf() 能安全处理 null，返回字符串"null"而非抛出异常；其内部显式判空，而 toString() 在 null 时直接报 NullPointerException。

string.valueof() 本身就能安全处理 null，不会抛出空指针异常。这是它与 tostring() 最关键的区别——你无需额外判空，直接传入可能为 null 的引用即可。

为什么 String.valueOf(null) 是安全的

Java 的 String.valueOf(Object obj) 方法内部做了显式判空：

• 如果参数为 null，直接返回字符串 "null"（注意是四个字符组成的字符串，不是字面量 null）；
• 否则调用该对象的 toString() 方法。

因此，下面的写法完全安全，不会触发 NullPointerException：

String s = String.valueOf(someObject); // someObject 可以为 null

对比 toString()：常见错误来源

直接调用 someObject.toString() 在对象为 null 时会立即抛出空指针异常：

• String s = someObject.toString(); // ❌ 若 someObject == null，运行时报错
• String s = String.valueOf(someObject); // ✅ 安全，返回 "null" 字符串

适用场景与注意事项

适用于所有引用类型（包括自定义类、集合、数组等），也兼容基本类型包装类（如 Integer、Boolean）：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

• 对 null 的 Integer：返回 "null"，不是 "0" 或空字符串；
• 对非 null 的 Integer：返回其数字对应的字符串，如 String.valueOf(42) → "42"；
• 对 null 数组：String.valueOf((String[])null) 返回 "null"（不是数组内容的字符串表示）。

不需要额外包装，但可按需定制 null 表示

若业务要求将 null 显示为空字符串 "" 或其他默认值（如 "-" ），可简单封装一层：

String safeStr(Object obj) {
  return obj == null ? "" : String.valueOf(obj);
}

但这属于语义定制，不是为避免空指针——原生 String.valueOf() 已经做到了零风险转换。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南