String.format 和 printf 共享 Formatter 机制,仅输出目标不同;需严格匹配参数类型与数量,推荐 String.format 以支持日志脱敏、测试断言等;注意 Locale 对数字/日期格式的影响,关键场景应显式指定 Locale.US。

String.format 和 printf 本质是同一套格式化机制
Java 中 String.format 和 System.out.printf 共享同一套格式化语法,底层都调用 java.util.Formatter。区别只在于输出目标:前者返回 String,后者直接写到控制台(并返回 PrintStream 自身)。这意味着所有格式说明符(如 %d、%s、%05d)和参数规则完全一致,学一个就等于会两个。
常见错误:参数类型不匹配或数量不对
最常触发的异常是 IllegalFormatConversionException 或 MismatchedFormatFlagsException,比如用 %d 格式化字符串,或用 %s 格式化 int 却传了 null(null 会被转成字符串 "null",但某些标志如 %.2s 遇到 null 会抛 NullPointerException)。
- 确保参数类型与转换符匹配:
%d对应byte/short/int/long/BigInteger;%s可接受任意对象(调用toString()) - 参数个数必须严格等于格式串中有效
%符号个数;%%是字面量百分号,不消耗参数 - 若需动态占位,优先用索引(如
%1$s %2$d %1$s),避免因参数顺序调整导致错位
实际开发中更推荐 String.format 而非 printf
除非是调试时快速打印,否则生产代码里应优先用 String.format。原因很实在:
-
printf无法捕获输出内容,没法做日志脱敏、异步写入或单元测试断言 -
String.format返回值可参与后续逻辑(如拼进 JSON、URL、SQL 模板),而printf是“一次性喷出”,不可逆 - 在高并发或重 IO 场景下,频繁调用
printf可能掩盖真实瓶颈——你以为在格式化,其实是在等 stdout 缓冲区刷新
示例:String msg = String.format("User[%d] logged in from %s", userId, ip); logger.info(msg);
本文档主要讲述的是Android数据格式解析对象JSON用法;JSON可以将Java对象转成json格式的字符串,可以将json字符串转换成Java。比XML更轻量级,Json使用起来比较轻便和简单。JSON数据格式,在Android中被广泛运用于客户端和服务器通信,在网络数据传输与解析时非常方便。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
立即学习“Java免费学习笔记(深入)”;
注意 locale 效应:数字/日期格式可能意外变化
String.format 和 printf 默认使用当前 Locale,这会影响小数点符号、千分位、月份名称等。例如在德语环境用 %f 会输出 3,141593 而非 3.141593,可能导致解析失败。
- 如需确定性输出(尤其涉及序列化、文件导出、API 响应),显式传入
Locale.US:String.format(Locale.US, "%.2f", 3.1415) -
System.out.printf无重载支持传Locale,此时必须改用String.format+println - 日期格式化建议直接用
DateTimeFormatter,别依赖%t系列,后者 locale 依赖更强且不易控制精度
真正容易被忽略的是:哪怕你没动过系统 locale,某些容器环境(如 Alpine Linux 镜像)默认 locale 是 C,而 JDK 8+ 在 C locale 下对浮点数的 %f 行为与 US 不同——这点在线上排查数字截断问题时经常卡住人。










