MessageFormat用于日志消息体的模板化动态填充，支持数字、日期、百分比等内置格式化，需注意单引号转义规则，推荐封装工具方法调用或在SLF4J不满足复杂需求时使用。

MessageFormat 主要用于结构化字符串模板替换，在日志输出中它不直接参与日志级别、时间戳等元信息渲染，但非常适合做“消息体”的动态填充——比如错误提示、业务事件描述、通知文案等需嵌入变量的固定句式。

日志消息体的模板化定义

将日志内容抽象为带占位符的模板，运行时注入实际值，既保证语义统一，又避免字符串拼接错误。例如：

• 模板定义："用户{0}在{1,date,yyyy-MM-dd}提交订单，总金额{2,number,currency}"
• 参数传入：new Object[]{"张三", new Date(), new BigDecimal("299.9")}
• 格式化结果："用户张三在2026-05-07提交订单，总金额¥299.90"

支持多类型格式化，提升可读性

MessageFormat 内置对数字、日期、时间、百分比等类型的格式化能力，无需手动转换：

• {0,number,#,##0.00} → 自动补零、千分位分隔
• {1,date,yyyy-MM-dd HH:mm:ss} → 统一时间格式，避免 SimpleDateFormat 线程安全问题
• {2,number,percent} → 0.85 直接转为 85%
• 组合使用："进度{0,number,percent}，耗时{1,number}ms，重试{2,number,integer}次"

模板与日志框架的配合方式

MessageFormat 不是日志框架原生组件，需在记录前手动处理消息体：

• 推荐封装工具方法：LogUtil.format("操作失败：{0}，原因：{1}", action, cause)
• 避免在 logger.info() 中直接调用 MessageFormat.format() 并传入未校验参数（空值可能抛 IllegalArgumentException）
• 若使用 SLF4J，更推荐其自带的占位符语法（{}）+ 参数自动绑定，简洁且线程安全；MessageFormat 更适合复杂格式或遗留系统兼容场景

注意单引号和转义细节

MessageFormat 把单引号 ' 当作转义字符，影响模板解析：

• 想输出字面量 'abc'，需写成 ''abc''
• 模板中出现未配对单引号（如 "用户'{0}'登录"），会导致解析异常
• 若模板本身含单引号且不想转义，建议先用 String.replace("'", "''") 预处理
• 纯文本内容建议优先用双引号包裹模板字符串，减少干扰