IllegalFormatFlagsException 是什么错误
这是 Java Formatter 或 String.format() 在解析格式化字符串时，遇到非法或冲突的标志（flags）时抛出的运行时异常。典型场景是用了不兼容的标志组合，比如同时写 %-+d（左对齐 + 正号），而 + 标志只对数值类型有效且不能和 - 共存。
哪些标志组合会触发这个异常
常见冲突组合包括：
-
%-+s：字符串不支持+标志，但写了就会报错 -
%0+d：0（补零）和+（显式符号）在整数格式中互斥 -
%,+#f：千位分隔符,和+在浮点数中虽可共存，但若用在不支持的类型（如String）上也会触发 -
%<strong> </strong>d（空格 flag）和+同时出现：两者语义重叠且不允许并列
怎么快速定位和修复
关键不是改代码逻辑，而是检查格式串里每个 % 占位符的 flags 部分是否合法：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 先确认参数类型：
s、d、f、o等对应的支持 flags 不同，查 Java Formatter 规范 的 “Flags” 表 - 删掉所有 flags，只留基本占位符（如
%d），再逐个加回，观察哪一步崩掉 - 注意转义：如果真要输出字面量
%，得写成%%，否则会被误解析为格式开始 - 示例修复：
String.format("%-+d", 42)→ 改成String.format("%+d", 42)（去掉-）或String.format("%-d", 42)（去掉+）
容易被忽略的兼容性细节
不同 JDK 版本对非法 flags 的容忍度略有差异，JDK 17 比 JDK 8 报错更严格；另外，MessageFormat 不走这套规则，它不会抛 IllegalFormatFlagsException，别混淆。
立即学习“Java免费学习笔记（深入）”；
真正麻烦的是嵌套模板——比如日志框架里拼接了外部传入的格式串，这时异常堆栈可能不指向你写的那行 String.format()，而是调用链下游。务必检查所有动态拼进格式串的变量是否含未转义的 % 或非法 flag。
