Java中MessageFormat实现国际化动态文本填充的核心是解耦语言资源与参数逻辑，使用{0}、{1}索引占位符，花括号需成对，{{}}转义，格式子句要求参数类型严格匹配，Locale必须显式传入，模板宜静态复用以提升性能。
Java 中用 MessageFormat 实现国际化动态文本填充，核心是把语言资源与参数逻辑解耦，让同一段模板适配不同语言的语序、格式和本地化规则。
占位符语法要严格配对
MessageFormat 使用 {0}、{1} 这类从 0 开始的索引占位符，不是 %s 风格。所有花括号必须成对出现：单个 { 或 } 会被当作文本原样输出，不会报错但也不替换——这是最常被忽略的问题。
- 想显示一个左花括号，写成
{{；右花括号写成}} - 资源文件里如
greeting={0}，欢迎回来！今天是{1,date,full}，必须确保{1,date,full}完整闭合 - 避免在拼接字符串时混入占位符，比如
"Hello " + name + "!"再传给 MessageFormat，会破坏结构
参数类型必须匹配格式子句
占位符后带格式说明（如 {0,date}、{1,number,currency}）时，传入参数类型必须严格对应，MessageFormat 不做自动转换。
-
{0,date}只接受java.util.Date或null；传Instant需先转：Date.from(instant) -
{0,number,currency}要求参数是Number子类（如Double、BigDecimal），不能传String或Long字面量 - 批量传参建议显式用
Object[]，避免 varargs 自动装箱引发隐式类型偏差
Locale 必须显式传入才可靠
即使系统默认 locale 是 zh_CN，不指定 locale 的 MessageFormat.format(pattern, args) 可能仍按英文规则格式化日期或数字——因为内部使用的 DateFormat 和 NumberFormat 实例可能缓存了旧配置。
立即学习“Java免费学习笔记（深入）”；
- 构造时指定：
new MessageFormat(pattern, Locale.CHINA) - 或用静态方法：
MessageFormat.format(pattern, Locale.US, args)（JDK 21+ 支持） - 资源文件加载也需配套 locale：
ResourceBundle.getBundle("messages", Locale.JAPAN)
模板复用可提升性能
MessageFormat 构造解析 pattern 的开销不小，尤其含复杂格式子句时。固定模板应声明为 static final，避免每次调用都新建实例。
- 推荐写法：
private static final MessageFormat GREETING_FMT = new MessageFormat("{0}，您好！余额：{1,number,currency}", Locale.CHINA); - 后续直接调用：
GREETING_FMT.format(new Object[]{name, balance}) - 若 locale 需动态切换，可缓存不同 locale 的 MessageFormat 实例，用 Map 管理
