### [01.02.010 设置全局语言池与前端启用语言](https://guaqi.com/docs/77501)

**Published:** 2026-09-11T02:18:53

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 瓜奇的语言配置分为「全局语言池」和「前端启用语言」。前者管理可用的内容语言，后者决定某个…

[01 入门与基础](/docs-archive/1196) / [01.02 语言与货币](/docs-archive/1200)

## 一、这个功能能做什么

瓜奇的语言配置分为「全局语言池」和「前端启用语言」。前者管理可用的内容语言，后者决定某个前端向客户提供哪些语言。

### 每个设置有什么用

| 设置  | 控制什么、会有什么效果 | 怎么填写或选择 |
| --- | --- | --- |
| 语言设置（全局语言池） | 决定后台有哪些语言可用于内容和翻译关联。 | 需要中文和英文时，先在这里准备两种语言。 |
| 语言名称 | 供人识别语言的显示文字。 | 可填写简体中文、English 等易识别名称。 |
| 语言代码 | 用于识别具体语言，不是任意备注。 | 从支持的选项选择；名称写英文不等于代码已经选对。 |
| 语言标志 | 为语言切换入口提供图标。 | 根据站点风格选择，修改图标不会改变译文内容。 |
| 默认货币 | 为该语言设置适用的默认币种。 | 还要核对目标前端是否启用该币种及商品是否有价格。 |
| 前端启用语言 | 决定某个网站实际向访客提供哪些语言。 | 从全局语言池中选取；不同前端可选不同组合。 |
| 前端语言第一项 | 作为该前端的默认语言。 | 例如英文站把英文放第一项；调整后按步骤重启对应前端服务。 |
| 自定义 JSON 语言包 | 修改界面按钮等默认译文。 | 默认译文够用时可留空；不负责翻译文章正文。 |
| 服务端错误 JSON | 修改已支持错误码的提示文案。 | 与界面语言包分开配置，不能交换文件用途。 |

### 三类翻译分别在哪里处理

| 希望改变的内容 | 对应操作 |
| --- | --- |
| 菜单按钮、界面提示 | 界面语言包或相应多语言配置字段 |
| 一篇文章的标题、正文和 SEO | 编辑目标语言内容，执行复制或翻译 |
| 分类名称和分类 SEO | 编辑该语言分类并建立翻译关联 |
| Node 返回的业务错误文字 | 服务端错误 JSON，对应稳定错误码 |

启用语言不会自动生成所有文章译文，也不会自动翻译所有分类名称。前台切换语言后缺少内容，应检查目标语言文章是否存在、是否发布，以及所属分类是否有对应语言版本。

### 默认语言与网址

从前台语言切换入口获取实际地址，再测试对应内容。不要只在原文章地址前添加一个语言前缀：不同语言的文章可能是不同 ID，且受目标前端分类范围限制。

只有中文版本的文章，切换到英文时可能找不到对应页面。请先建立并发布英文版本，再检查语言切换链接。

继续阅读[设置内容语言和翻译关联](/docs/77561)。

### 先认识这几个词

-   **JSON**：一种保存结构化文字数据的文件格式；修改时需要保持正确格式。
-   **前端**：访客实际打开和使用的网站；同一后台可以对应多个前端网址。
-   **Node**：运行瓜奇前端服务的程序环境；重启对应服务属于网站部署操作。

## 二、设置后会有什么效果

例如全局准备中文和英文，资料站启用两种语言，另一个前端只启用英文。访客可在相应站点切换语言，但文章和分类需要另行准备译文。

## 三、怎么使用

### 添加和启用语言

1.  在瓜奇主站配置的「语言设置」中添加语言，从待选项选择语言代码。
2.  填写语言名称、语言标志，选择该语言默认货币。语言名称用于前台切换入口。
3.  默认界面译文够用时，「自定义 JSON 语言包」可以留空；需要修改译文时再上传。
4.  保存主站配置，再在目标前端的「前端启用语言」中选择语言。
5.  将希望作为该前端默认语言的项放在第一位，保存。
6.  新增、删除或调整语言顺序后，重启对应前端 Node 服务，再检查语言切换入口和页面访问。

前端选择器只能从主站语言池选取，不能直接新增语言代码。主站第一项语言存在保存保护，不应把更换主站默认语言当作普通拖动排序操作。

## 四、常见问题

### 常见问法与直接答案

#### 怎么增加英文或另一种语言？

先在全局语言池配置支持的语言，再在目标前端的启用语言中选入。首项是该前端默认语言；按教程更新并重启对应 Node。随后建立文章及分类的目标语言内容或关联，并填写界面语言字段。增加语言开关本身不会自动翻译已有文章。

### 相关问题入口

-   [复制文章到其他语言并检查关联内容](/docs/77566)
-   [设置菜单导航与用户菜单](/docs/77635)
-   [配置自定义界面和错误语言文案](/docs/77503)



---