Java Locale.ROOT 固定机器可读字符串大小写的做法

处理协议键、文件扩展名、枚举文本或 HTTP 头字段时，大小写转换应使用 Locale.ROOT，不要依赖机器的默认语言环境。最常见的写法是 value.toLowerCase(Locale.ROOT) 或 value.toUpperCase(Locale.ROOT)；面向用户的姓名、菜单和提示语则应继续使用用户 Locale。

先分清用户文本与机器标识符的边界

Locale 的职责是给语言、地区或文化相关操作提供规则。Locale.ROOT 没有语言、国家和变体，被 Java API 定义为语言和国家中立的基础 Locale。它并不代表美国英语，也不会把内容翻译成某种用户语言。

用 Locale.ROOT 固定大小写转换

下面的转换函数只负责把机器可读标识符归一到小写。代码注释保留了两个重要边界：空值由调用方决定是否拒绝；转换后的字符串不保证与输入等长。

import java.util.Locale;

public final class MachineKey {
    private MachineKey() {}

    public static String normalize(String raw) {
        if (raw == null) {
            // 协议字段缺失时尽早失败，避免把 null 误当成合法键。
            throw new IllegalArgumentException("machine key is required");
        }
        // ROOT 不读取主机语言，适合协议键、扩展名和枚举文本。
        return raw.strip().toLowerCase(Locale.ROOT);
    }
}

如果业务规范要求大写，把最后一段改成 toUpperCase(Locale.ROOT)。不要把 Locale.ENGLISH 当作通用替代品：机器文本的意图是语言无关，而不是“按英语用户习惯显示”。

用 Turkish 环境做一次可重复的回归检查

Java 文档明确说明，无参大小写方法等价于使用 Locale.getDefault()。在 Turkish Locale 下，"TITLE".toLowerCase() 可能得到包含无点小写 ı 的结果；这类差异足以让协议键、缓存键或文件扩展名匹配失败。

import java.util.Locale;

public class LocaleCaseCheck {
    public static void main(String[] args) {
        Locale old = Locale.getDefault();
        try {
            // 模拟土耳其语宿主机，验证无参方法会读取默认 Locale。
            Locale.setDefault(Locale.forLanguageTag("tr-TR"));
            String implicit = "TITLE".toLowerCase();
            String stable = "TITLE".toLowerCase(Locale.ROOT);

            // 机器键只接受与规范一致的稳定结果。
            if (!"title".equals(stable)) {
                throw new AssertionError("ROOT conversion changed");
            }
            System.out.println(implicit);
            System.out.println(stable);
        } finally {
            // 测试结束恢复进程级默认值，避免污染同一 JVM 中的其他测试。
            Locale.setDefault(old);
        }
    }
}

转换之后仍要检查三个边界

第一，strip() 是否属于协议规范，不能因为示例方便就默认删除空白。第二，大小写映射可能是一对多，结果长度可能变化，所以不要用固定下标假设转换前后字符一一对应。第三，若只是做不区分大小写的匹配，应把比较策略写清楚，不能把“先转小写”当作完整 Unicode 规范化、排序或安全校验。

工程上可以把 Locale 作为参数只留给用户显示层，把 Locale.ROOT 封装在协议键、序列化字段和文件名规范化函数中。这样调用点不会悄悄受操作系统语言影响。

常见问题

Locale.ROOT 等于 Locale.ENGLISH 吗？

不等于。ROOT 是语言、国家和变体都为空的中立 Locale；ENGLISH 明确表示英语。机器可读文本优先表达语言无关意图，因此通常选 ROOT。

所有 Java 字符串都应该使用 Locale.ROOT 吗？

不是。用户界面、姓名和本地化搜索词应传入用户 Locale；只有语言无关的协议或内部标识符才适合固定 ROOT。

为什么不能只在测试机器上验证 toLowerCase？

因为无参方法读取默认 Locale，部署环境可能不同。把 Turkish 等 Locale 写进回归测试，才能把隐含环境依赖变成明确的断言。