string.format()异常规避需三步：编译期拦截（-xlint:format、ide语法检查）、参数预控（统一用%s兜底、null安全处理）、格式约定（禁用自动替换、日期用datetimeformatter）。
java中string.format()看似简单，但实际运行时容易因占位符、参数、类型或空值问题触发多种异常——illegalformatconversionexception、unknownformatconversionexception、missingformatargumentexception，甚至间接引发nullpointerexception。规避关键不靠“运气”，而在于编译期拦截、参数预控和格式约定三步到位。
用编译器和IDE提前拦住错误
别等运行时报错才去查。启用 -Xlint:format 编译选项，Javac会直接警告占位符与参数类型不匹配（如%d传String）或格式符非法（如%z）。IntelliJ IDEA默认开启「Format string syntax error」检查，Eclipse也支持Formatter语法校验插件。这类提示在写代码时就标红，比调试快十倍。
- 在Maven项目中，于
pom.xml的maven-compiler-plugin配置里添加<compilerargs><arg>-Xlint:format</arg></compilerargs> - 禁用“自动替换字符串拼接为format”的IDE提示（如IntelliJ的「String concatenation can be replaced with format()」），避免它把安全的
"a=" + a强行改成有风险的String.format("a=%s", a)
统一用%s兜底，谨慎使用强类型占位符
%d、%f、%t这些强类型占位符虽精确，但容错性差：传Integer给%f、传String给%td都会立刻抛IllegalFormatConversionException。除非业务强依赖数值精度或日期格式（如日志中必须输出两位小数），否则优先用%s——它接受任意对象，对null也返回"null"而非NPE。
- 需要整数显示？先转成String：
String.format("count: %s", String.valueOf(count)) - 要控制浮点精度？用DecimalFormat或String.format("%s", String.format("%.2f", value))双层兜底，避免%f直面非Number类型
- 日期格式化不用%td，改用DateTimeFormatter：
LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd"))
参数数量与空值必须显式防御
MissingFormatArgumentException本质是“少传了参数”，常见于动态拼接格式串后忘记补全参数列表；而null虽不直接抛NPE，但输出"null"可能污染日志或前端展示。这两类问题必须在调用前做判断。
- 格式串含n个
{}或%占位符，就确保args数组长度≥n——可用工具方法校验：if (args.length - 对可能为null的参数，统一用
Objects.toString(obj, "N/A")替代裸传，既防展示异常，也避免后续逻辑误判"null"字符串为有效值 - 禁止在日志中混用SLF4J的
{}和String.format的%s，团队内强制规定：日志一律用{}，业务字符串拼接才用format
高频场景用更安全的替代方案
不是所有地方都该用String.format。循环内拼接、大量日志、模板化文本，它既是性能瓶颈也是异常温床。
- 循环中拼接：改用StringBuilder.append()，避免每次format都新建String对象
- 结构化日志：用SLF4J + 参数化占位符（
log.info("user {} logged in at {}", userId, time)），它不解析%符号，也不会因参数多/少而异常 - 复杂模板：引入MessageFormat或开源库如Apache Commons Text的StrSubstitutor，支持变量回退、嵌套表达式，比硬写format串健壮得多
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
