多语言不是加一个语言代码就完事。前台切换、内容翻译、界面文案和词库各自独立,最容易混的是「一键翻译」和「自动补全」到底管什么。这篇按实际后台流程讲清楚。

一、启用语言与前台切换
在「设置 → 内容与媒体 → 多语言」(/admin/settings/content/i18n)填「已启用语言」,用英文逗号分隔,例如 zh-CN,en,ja。必须包含 zh-CN,否则保存不了;代码 2–3 位字母开头,可带地区后缀;重复会自动去重。只启用一种语言时,前台不显示切换按钮。
切换表单提交到 POST /locale,设置一年有效的 kc_lang Cookie 并跳回当前页面,路径不变。语言判断顺序是:地址里的 ?lang=、Cookie、默认语言。系统不读浏览器的 Accept-Language,所以第一次访问默认显示中文;要直接打开英文页,用 /about?lang=en,同时也会刷新 Cookie。
二、哪些字段可以翻译
| 内容 | 可翻译字段 |
|---|---|
| 文章 | 标题、摘要、正文、SEO 标题、SEO 描述 |
| 栏目 | 名称、SEO 标题、SEO 描述 |
| 单页 | 名称、正文、SEO 标题、SEO 描述 |
路径名和 SEO 关键词不参与翻译,所有语言共用同一个地址。译文只有在主表单保存时才写入,没保存就离开不会保留;清空译文并保存会删除该字段译文,前台回退中文原文。

三、一键翻译的边界
- 先填好中文并保存,再点「翻译」;系统把中文一次发给 AI,同时翻译所有已启用的外语;
- 会覆盖译文区当前内容,包括手工改过的译文;
- 翻译结果不会自动保存,必须再点「保存」;
- 正文译文按正文规则清洗 HTML;
- 中文原文在上次保存译文后变了,旁边会显示「中文已修改」,保存时以输入框当前内容为准;
- 没有配置 AI 服务或调用失败时,只提示错误,原有内容不会被清空。
站点名称、分享标题/描述也有按语言的译文区,但那里的「一键翻译」只翻译当前语言,且只填还空着的译文,不覆盖已填内容。默认 META 只有一份,不分语言。
四、「更新翻译」和「自动补全」不是一回事
保存文章时勾选「更新翻译」,会为所有已启用语言生成翻译任务,只有有内容的字段才会翻译,空字段不生成译文。而「语言和国家」页面里的「自动补全翻译」开关只管系统界面文案和帮助,不影响发布的内容——这是最常见的误解。
五、回退、界面文案与词库
缺少译文的字段自动显示中文原文;这是逐字段回退,不是整页回退。前台导航、按钮等固定文字在「界面文案」(/admin/ui-strings)维护,点「翻译」只填空单元格。专有名词的固定译法放「翻译词库」(/admin/glossary),同一语言下中文原词不能重复,AI 翻译时优先使用词库译文。
六、常见坑
- 切了语言但内容没变:先看该字段有没有译文,缺译文会回退中文;
- 刚翻译完刷新又变中文:翻译结果没保存;
- 改了中文,译文没变:看「中文已修改」标记,重新翻译或手改;
- 关了某种语言,译文丢了吗:没有,重新启用后还在;
- 想靠「自动补全」翻译文章:不行,那个开关只管界面和帮助。
小结
多语言要分工看:语言开关决定前台能不能切,译文区决定内容显示什么,AI 服务决定一键翻译能不能用,词库决定专有名词怎么译。把「内容翻译」和「界面补全」分开,基本不会踩坑。