在Java中如何格式化输出内容_Java格式化语法解析

优先选Stri

ng.format——它不耦合IO,方便测试、拼接和日志;仅调试时用printf。两者底层逻辑相同,但需严格匹配类型与占位符,注意宽度、精度顺序及线程安全的DateTimeFormatter替代SimpleDateFormat。

Java里用printf还是String.format?选哪个更稳

两者底层共用同一套格式化逻辑,语法完全一致,区别只在使用场景:printf直接输出到控制台或流,String.format返回格式化后的字符串。日常开发中优先选String.format——它不耦合IO,方便测试、拼接、日志记录;只有调试快速打印时才用printf

常见错误是混用参数类型和占位符,比如用%d去接double值,会抛IllegalFormatConversionException。Java不会自动类型转换,必须严格匹配:

  • %dintlongshort(不能是Double包装类)
  • %ffloatdouble
  • %s → 任意对象(调用toString()
  • %tFjava.util.Datejava.time.temporal.TemporalAccessor(如LocalDateTime

printf的宽度、精度和对齐怎么控制

格式化字符串里%后可加一串修饰符,顺序固定:%[flags][width][.precision]conversion。容易出错的是把width.precision位置写反,或者对整数误加.2(整数不支持小数精度)。

实际常用组合:

  • %-10s:左对齐,最小宽度10,不足补空格
  • %08d:右对齐,最小宽度8,不足补前导零
  • %.2f:保留2位小数,四舍五入(注意:不是截断)
  • %,d:添加千位分隔符(如12345671,234,567
System.out.printf("金额:%,.2f 元,编号:%06d%n", 12345.678, 42);

输出:金额:12,345.68 元,编号:000042。注意%n是平台无关换行符,别用\n

Java 8+ 时间格式化为什么SimpleDateFormat要避免

SimpleDateFormat不是线程安全的,多线程共用一个实例必出问题(比如日期错乱、解析失败)。替代方案是用java.time包里的不可变类:

  • 格式化输出用DateTimeFormatter(线程安全,可复用)
  • 它不接受new Date(),必须转成InstantLocalDateTime
  • 预定义常量如DateTimeFormatter.ISO_LOCAL_DATE_TIME比手写模式串更可靠
LocalDateTime now = LocalDateTime.now();
String s = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
// 输出:2025-06-15 14:23:05

如果必须兼容旧代码,每次用都new SimpleDateFormat("..."),但性能差,不推荐。

自定义对象怎么让%s输出得干净

默认System.out.printf("%s", obj)调用obj.toString(),而Object基类的实现只返回类名+哈希码,毫无可读性。必须重写toString()方法。

关键点:

  • 别在toString()里抛异常或做耗时操作(如DB查询)
  • 字段值为空时建议显式写"null""",而不是留空或触发NPE
  • 如果对象有敏感字段(如密码),toString()里应脱敏,不能原样输出
public class User {
    private String name;
    private String password;
    @Override
    public String toString() {
        return "User{name='" + name + "', password='[PROTECTED]'}";
    }
}

这样printf("%s", new User())才不会泄露信息或崩溃。

实际项目里最常被忽略的是printf的异常处理——它遇到格式错误不会编译报错,而是运行时报IllegalFormatException,且堆栈指向printf调用处,不是格式串本身。建议把复杂格式串提取为常量,并在单元测试里覆盖边界值。