%s对应任意对象(含null),%d仅接受整数类型,%f接受浮点类型;参数类型与顺序必须严格匹配,否则抛illegalformatconversionexception或missingformatargumentexception。

Java String.format() 中 %s、%d、%f 的基本对应关系
这些占位符不是“随便写写就能用”,而是严格按参数类型和顺序匹配的。用错类型会直接抛 IllegalFormatConversionException 或输出异常结果。
常见对应规则:
-
%s→ 任意对象(调用toString()),包括null(输出字符串"null") -
%d→ 十进制整数,仅接受byte、short、int、long、BigInteger;传double或String会报错 -
%f→ 浮点数,接受float、double、BigDecimal;传整数如int会自动装箱为double,但不推荐依赖这种隐式转换
格式化数字时容易被忽略的精度与宽度控制
只写 %f 默认输出 6 位小数,且不补零、不截断,可能产生冗长结果(如 3.1415926535 → "3.141593")。真正可控的写法是带精度说明符:%.2f 表示保留两位小数并四舍五入。
常见组合示例:
立即学习“Java免费学习笔记(深入)”;
String.format("%.2f", 3.14159) // → "3.14"
String.format("%6.2f", 3.14159) // → " 3.14"(总宽6字符,左补空格)
String.format("%06.2f", 3.14159) // → "003.14"(总宽6,左补0)
String.format("%,d", 1000000) // → "1,000,000"(千位分隔符)
注意:%,d 在某些区域设置下可能不生效(比如非 US locale),必要时应显式传入 Locale.US。
传参顺序错乱或数量不匹配的典型错误
String.format() 不做运行时类型检查,出错往往在执行时才暴露。比如:
String.format("ID:%d, Name:%s", "Alice", 123)
这段代码会抛 java.util.IllegalFormatConversionException: d != java.lang.String —— 因为第一个占位符 %d 对应了字符串 "Alice"。
更隐蔽的问题是参数个数不足:
String.format("Price: %.2f, Tax: %.2f", 99.9)
只会输出 "Price: 99.90, Tax: " (第二个 %.2f 没有值,静默忽略?不,实际会抛 MissingFormatArgumentException)。
安全做法:
- 确保参数个数 ≥ 占位符个数
- 整数优先用
%d,浮点优先用%f,别混用 - 不确定类型时,先转成
String再用%s(牺牲一点性能换稳定性)
替代方案:为什么有时候该避开 String.format()
它底层依赖 Formatter 类,每次调用都新建对象、解析模式串,高频场景(如日志拼接、循环内格式化)会有明显开销。
可考虑的替代方式:
- 简单拼接用
String.valueOf()++(JDK 9+ 字节码已优化) - 需要复用格式时,用
java.util.Formatter实例缓存(避免重复解析) - 结构化日志推荐 SLF4J 的
logger.info("User {} logged in at {}", userId, time)—— 它延迟格式化,且不触发toString()除非开启 DEBUG
最常被忽略的一点:当占位符里含 % 字符本身(比如要输出百分比),必须写成 %%,否则会被误认为格式符开头——这个反斜杠式转义逻辑,和正则、SQL 都不同,容易漏掉。











