本页目录

自称与他称:语言徽章上的名字

英文站的文章列表里,一篇还没有英文译文的中文文章,标签上写着「中文」。

乍看没错——那确实是中文。但读者正站在英文界面上,这一行里其他文字全是英文,只有这个徽章突然换了语言。

症状与根因

徽章的写法很直接:

{languages[postLang(post)].label}

languages 当时长这样:

export const languages = {
  zh: { label: '中文', short: '中' },
  en: { label: 'English', short: 'EN' },
} as const

label 是语言的自称。语言切换器用它是对的:读者要在一堆语言里找到自己的母语,中文、English 这种自称最好认。但列表徽章不是在让读者挑语言,而是在当前语言的语境里描述另一篇内容的语言,这时应该跟着界面语言变:英文站写 Chinese,中文站写 英文。

自称和他称,是两件事,而 languages 只提供了其中一件。

一处在写,两处在读

顺手搜了一下 languages[...].label,时间轴组件里也有同样的写法。所以问题不在某个组件写错了一行,而是数据结构本身在两种语义之间含糊。改的时候一起改:模板里各换一行,切换器保持原样。

三种做法

把翻译直接塞进 languages 是最顺手的选择:

zh: { label: '中文', names: { en: 'Chinese', zh: '中文' } }

能跑,但 languages 从此同时存着自称和他称,下次写新组件时还是得先想一遍该用哪个字段。

Intl.DisplayNames 更省事,一个语言名都不用维护:

new Intl.DisplayNames(['zh'], { type: 'language' }).of('en') // 英语

代价是措辞交给 ICU:中文语境下它给「英语」,而徽章旁边写「英文」更贴;而且输出会随构建机上 Node 的 ICU 版本变化。对一个只有两种语言的博客来说,这点不可控不值得。

所以选了第三种:单独一张按界面语言索引的表。

const languageNames: Record<Lang, Record<Lang, string>> = {
  en: { en: 'English', zh: 'Chinese' },
  zh: { en: '英文', zh: '中文' },
}

/** Name of language `code` written in `lang`. */
export function languageName(code: Lang, lang: Lang): string {
  return languageNames[lang][code]
}

Record<Lang, Record<Lang, string>> 这个类型是关键:将来加一门语言,编译器会逼着你在每一格补上名字,不会漏掉「法语站上日语叫什么」这种边角。

组件里的调用

{postLang(post) !== lang && (
  <span title={t('blog.originalLanguage')}>{languageName(postLang(post), lang)}</span>
)}

提示文案仍然走 t('blog.originalLanguage'),它本来就是界面语言的一部分;只有语言名从自称换成了他称。时间轴那边的写法也一样,多了一个 · 分隔符。

验证

构建后检查产物,英文站列表里的徽章从 中文 变成了 Chinese。中文站反而一个徽章都没有——现有文章都有中文版,回退分支根本没走到,所以这个 bug 只在英文站显形。

类型检查和 lint 都过。

回过头看

这类 bug 的根源很少是某行模板写错,而是一个数据结构承担了两个语义。语言名的「自称」和「他称」看起来只差一次翻译,实际差的是——读者站在哪一边。