JavaScript Intl.Locale 怎样补全脚本与地区子标签

如果你拿到的语言标识缺了脚本或者地区子标签，直接用原生的 Intl.Locale 实例的相关属性，就能自动补全符合 BCP 47 规范的完整标识，不用额外引入第三方国际化库处理映射关系。

如果拿到的只有 zh、en 这样的语言标签，却需要继续读取脚本和地区，直接访问 script 或 region 往往得到空值。解决方法是调用 Intl.Locale.prototype.maximize()：它会依据 Unicode 的 likely subtags 规则，返回一个补出最可能 language、script、region 的新 Intl.Locale 对象。

例如，new Intl.Locale("zh").maximize().baseName 通常会得到 zh-Hans-CN，而 zh-TW 会得到以繁体脚本和台湾地区为核心的标签。这里的“最可能”是语言标签推断，不是读取用户真实位置，也不是替用户做语言偏好选择。

官方参考：https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/maximize

先确认缺的是哪一层标签

Intl.Locale 把 Unicode locale identifier 拆成语言标识和扩展信息。语言标识的核心顺序是 language、script、region，baseName 只包含这部分核心名称；像日历、数字系统、时钟周期等内容则属于可选的扩展标签。

用 maximize 补出最可能的脚本和地区

最小写法只需要构造 Locale，再调用 maximize()。该方法没有参数，返回新的 Locale 实例，不会修改原对象，所以可以同时保留原始标签和补全后的结果。

const source = new Intl.Locale("zh");
const expanded = source.maximize();

// 读取核心语言标识，便于决定字体、排版或地区格式。
console.log({
  original: source.baseName,
  complete: expanded.baseName,
  language: expanded.language,
  script: expanded.script,
  region: expanded.region,
});

// source 仍然保持为 "zh"；maximize() 返回的是新对象。
console.log(source.baseName);

MDN 的示例展示了 en 可补为 en-Latn-US，ko 可补为 ko-Kore-KR。不要把这些值理解成硬编码映射表；它们来自语言标签的 likely subtags 数据，应用只应把结果当作“最可能的默认值”。

读取完整结果时不要混淆 baseName 和 toString

需要展示或传递完整语言标签时，用 toString()；需要只比较语言、脚本和地区核心时，可读取 baseName。下面的函数同时返回两种结果，并保留输入中的 Unicode 扩展信息。

function describeLocale(tag) {
  const locale = new Intl.Locale(tag);
  const expanded = locale.maximize();

  // baseName 只看 language-script-region，toString() 还会带上 -u 等扩展。
  return {
    input: locale.toString(),
    baseName: expanded.baseName,
    language: expanded.language,
    script: expanded.script,
    region: expanded.region,
    fullTag: expanded.toString(),
  };
}

console.log(describeLocale("fr-u-ca-gregory-hc-h12"));

例如输入包含 -u-ca-gregory-hc-h12 时，maximize() 只补语言标识的主标签，扩展部分仍然保留。若只打印 baseName，看不到日历和时钟周期；若要序列化完整 Locale，应使用 toString()。

把完整标签用于展示，把短标签用于存储

如果数据交换或界面展示需要明确脚本和地区，可以保存 expanded.toString()；如果只需要一个尽可能短的等价语言标识，可以在已经完整的 Locale 上调用 minimize()。它会尝试移除调用 maximize() 时能够重新补出的主标签。

const detailed = new Intl.Locale("fr-Latn-FR-u-ca-gregory");
const compact = detailed.minimize();

// 只压缩语言、脚本和地区；日历扩展仍保留。
console.log(compact.baseName); // "fr"
console.log(compact.toString()); // "fr-u-ca-gregory"

// 需要明确默认地区时，优先保留 maximize() 的结果。
console.log(detailed.maximize().baseName);

常见误区是把 maximize() 当成浏览器语言检测器，或者把 script、region 的补全结果直接当成用户选择。更稳妥的做法是：把它用于默认格式、字体或资源选择；当用户明确选择了地区或脚本时，以用户输入覆盖推断结果。

常见问题

maximize() 会修改原来的 Locale 吗？

不会。它返回新的 Intl.Locale 实例，原对象的 baseName、script 和 region 保持不变。

为什么 maximize() 后仍然没有我想要的地区？

因为它给出的是最可能值，不是业务地区选择器。如果业务已经知道用户选择的是某个地区，应在构造 Locale 时显式写入 region，而不是依赖 likely subtags。

什么时候应该使用 minimize()？

当你希望在不丢失语义的前提下缩短语言标签时使用。展示诊断信息或跨系统传递时，通常先保留清晰的完整标签。