Java ListFormat怎样按Locale格式化多项文本

如果页面要显示“周一、周三和周五”这类用户可见的清单文本，直接使用 String.join 往往只能固定一种分隔符，换到英文、日文或“任选其一”的语义时就不够用了。Java 的 java.text.ListFormat 可以把 Locale、列表语义和简繁程度一起交给标准库处理。

结论：用 ListFormat.getInstance(locale, type, style).format(items) 生成展示文本；空列表要提前处理，parse 只适合明确约束过分隔符的输入，不能默认当作无损反序列化。

官方资料：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/ListFormat.html

先判断：String.join 为什么不够

String.join("、", items) 适合日志、内部标识或格式固定的输出，但它不知道“标准列举”“二选一”和“单位串列”之间的区别，也不会随 Locale 改变连接词。ListFormat 按 Unicode LDML 的清单模式组织文本，适合直接交给用户阅读的界面文案、邮件摘要和通知内容。

选择 Locale、Type 和 Style

Locale 决定语言环境；Type 决定连接语义；Style 决定表达的完整程度。普通陈述通常选 STANDARD，表达“甲或乙”选 OR，只想把单位名称紧凑排列时可选 UNIT。FULL 最完整，SHORT 和 NARROW 更适合空间有限的卡片或标签。

动手写：把多项文本格式化成用户可读结果

下面的例子把普通陈述和“任选其一”分开，避免在业务代码中手工拼接逗号与连接词。

import java.text.ListFormat;
import java.util.List;
import java.util.Locale;

public class LocalizedListText {
    public static void main(String[] args) {
        // 用户可见的清单至少要有一项；空列表交给业务层决定提示语。
        List items = List.of("Foo", "Bar", "Baz");
        if (items.isEmpty()) {
            System.out.println("暂无可选项");
            return;
        }

        // STANDARD 表示普通列举，FULL 保留完整的连接词与标点。
        ListFormat standard = ListFormat.getInstance(
                Locale.US, ListFormat.Type.STANDARD, ListFormat.Style.FULL);
        System.out.println(standard.format(items));

        // OR 表示候选项之间是“或”关系，不要用普通逗号掩盖语义。
        ListFormat alternatives = ListFormat.getInstance(
                Locale.US, ListFormat.Type.OR, ListFormat.Style.FULL);
        System.out.println(alternatives.format(items));
    }
}

示例中的重点不是固定输出某一个英文句子，而是把“语言环境”和“列表关系”变成显式参数。切换到其他 Locale 后，标点和连接词由对应的本地化数据决定，不要在测试里把所有语言都写死成英文结果。

排查：format 和 parse 为什么不一定往返

ListFormat 同时提供 format 和 parse，但两者并不保证任意输入都能无损往返。如果元素本身带有逗号等分隔符，格式化后的文本可能被解析成更多元素。还要注意：空列表调用 format 会抛出 IllegalArgumentException，传入 null 则会触发空值异常。

如果文本来自数据库字段或用户输入，建议把原始列表作为结构化数据保存，展示时调用 format；只有在输入格式和元素内容都受控时，才把 parse 作为辅助入口。它更像“按清单规则尝试解析”，不是 JSON 那样的结构化编码。

最后记住这三个边界

• 面向用户的本地化列举用 ListFormat，内部固定格式才考虑 String.join。
• 先按语义选 Type，再按空间选 Style；不要为了省字符牺牲“或”与“和”的含义。
• 空列表、null 和带分隔符的元素都要在业务层设定规则，不能把库的异常或解析猜测当成产品文案。

相关问题

ListFormat 能不能替代所有字符串模板？

不能。它专门解决“多个字符串组成一个清单”的本地化模式，带变量占位、复数规则或整句模板时仍应使用更合适的消息格式化方案。

为什么测试不应该只断言英文完整句子？

因为 Locale、CLDR 数据和 Type/Style 都会影响标点与连接词。测试应同时断言选择的参数、元素顺序和关键语义，避免把某个语言环境的展示细节误当成跨语言契约。