Java MessageFormat 中单引号为什么会吞掉占位符

Java MessageFormat 中占位符突然原样输出，常见原因不是参数没有传进去，而是模式里的单引号改变了解析边界。'{0}' 会把 {0} 当成普通文本；如果既要保留撇号，又要让占位符继续替换，应写成 ''{0}''。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/MessageFormat.html

MessageFormat 的单引号是模式语法，不只是普通标点：成对单引号包住的内容不会解析格式元素；字面单引号需要写成两个连续单引号。

先看单引号怎样改变占位符

下面两个模式只差一层单引号，但结果完全不同。第一个模式把占位符包成了字面文本，第二个模式用两个单引号输出撇号，同时仍然让 {0} 参与格式化。

import java.text.MessageFormat;

public class QuoteBoundaryDemo {
    public static void main(String[] args) {
        // 成对单引号会把 {0} 变成普通文本，不会读取参数
        String literal = MessageFormat.format("'{0}'", "Java");
        System.out.println(literal); // 输出：{0}

        // 两个连续单引号表示一个字面单引号，{0} 仍然是占位符
        String formatted = MessageFormat.format("''{0}''", "Java");
        System.out.println(formatted); // 输出：'Java'
    }
}

这里的关键不是 Java 字符串转义，而是 MessageFormat 第二次解析模式时看到的字符。Java 源码中的双引号仍要按字符串规则处理；进入 MessageFormat 后，单引号才按模式规则解释。

想保留撇号时为什么必须写两个

在普通英文消息中，撇号经常出现在单词内部，例如 user's。如果模式还包含占位符，直接写一个单引号可能会意外开启引用区。把它写成两个连续单引号，格式化器会把这一对折叠成一个可见撇号。

因此，排查时先把模式中的单引号成对标出来，再看占位符是否落在引用范围内。不要先怀疑 Object[] 的顺序；只要参数索引合法，引用规则就可能让传入值看起来像“没有生效”。

资源文件里最容易出现哪类回归

国际化消息通常来自 properties 或其他资源文件，翻译人员可能为了自然表达加入撇号。官方文档特别提醒，翻译字符串里可能需要单引号，而原始语言没有；一旦消息会经过 MessageFormat，它就必须遵守同一套引用规则。

import java.text.MessageFormat;
import java.util.Locale;
import java.util.ResourceBundle;

public class BundleMessageDemo {
    public static void main(String[] args) {
        // 资源文件中的值仍然会按 MessageFormat 模式解释
        ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.ENGLISH);
        String pattern = bundle.getString("welcome");

        // 先固定参数，再打印最终文本，便于发现占位符被当成字面量
        String message = MessageFormat.format(pattern, "Ada");
        System.out.println(message);
    }
}

可以给资源文件建立一个很小的复查约定：包含 {0}、{1} 等格式元素的值，在出现字面撇号时统一写成 ''；如果确实要显示花括号和占位符文字，再用成对单引号明确包住。这样翻译审校时能区分“要显示的文字”和“要替换的参数”。

修复后怎样选择合适的写法

如果消息只是在 Java 代码中拼接固定文本，普通字符串拼接或文本块可能更直观；如果需要按 Locale 格式化日期、数字和参数，继续使用 MessageFormat，但应把模式集中在资源文件，并在代码旁说明它会被格式化器再次解析。

• 要显示参数值：不要把 {0} 放在单引号引用区内。
• 要显示字面单引号：写成 ''，不要依赖某个 Locale 的偶然表现。
• 看到占位符原样输出：检查前后是否有单引号，以及是否存在一个未配对的单引号。
• 改过翻译资源后：至少用一个真实参数调用一次 MessageFormat.format，检查撇号、参数值和花括号是否同时正确。

常见问题

为什么把单引号删掉后就正常了？

因为删掉后 {0} 回到了未引用的模式区域，格式化器可以把它识别成 FormatElement。真正的修复不是一律删除标点，而是在需要显示撇号时使用两个连续单引号。

未配对的单引号一定会抛异常吗？

不一定。官方规则把未配对的单引号视为在模式末尾闭合，所以它可能悄悄吞掉后续占位符，而不是立刻报错。这也是资源文件变更需要配合最小格式化示例复查的原因。