优先选String.format——它不耦合IO,方便测试、拼接和日志;仅调试时用printf。两者底层逻辑相同,但需严格匹配类型与占位符,注意宽度、精度顺序及线程安全的DateTimeFormatter替代SimpleDateFormat。
printf还是String.format?选哪个更稳两者底层共用同一套格式化逻辑,语法完全一致,区别只在使用场景:printf直接输出到控制台或流,String.format返回格式化后的字符串。日常开发中优先选String.format——它不耦合IO,方便测试、拼接、日志记录;只有调试快速打印时才用printf。
常见错误是混用参数类型和占位符,比如用%d去接double值,会抛IllegalFormatConversionException。Java不会自动类型转换,必须严格匹配:
%d → int、long、short(不能是Double包装类)%f → float、double
%s → 任意对象(调用toString())%tF → java.util.Date或java.time.temporal.TemporalAccessor(如LocalDateTime)printf的宽度、精度和对齐怎么控制格式化字符串里%后可
加一串修饰符,顺序固定:%[flags][width][.precision]conversion。容易出错的是把width和.precision位置写反,或者对整数误加.2(整数不支持小数精度)。
实际常用组合:
%-10s:左对齐,最小宽度10,不足补空格%08d:右对齐,最小宽度8,不足补前导零%.2f:保留2位小数,四舍五入(注意:不是截断)%,d:添加千位分隔符(如1234567 → 1,234,567)System.out.printf("金额:%,.2f 元,编号:%06d%n", 12345.678, 42);
输出:金额:12,345.68 元,编号:000042。注意%n是平台无关换行符,别用\n。
SimpleDateFormat要避免SimpleDateFormat不是线程安全的,多线程共用一个实例必出问题(比如日期错乱、解析失败)。替代方案是用java.time包里的不可变类:
DateTimeFormatter(线程安全,可复用)new Date(),必须转成Instant或LocalDateTime
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"或"" ,而不是留空或触发NPEtoString()里应脱敏,不能原样输出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调用处,不是格式串本身。建议把复杂格式串提取为常量,并在单元测试里覆盖边界值。