瓜奇提供两种自定义语言文件：「自定义 JSON 语言包」修改界面文字，「服务端错误 JSON」修改 Node 返回的错误提示。它们分别配置，不能互换。
找到对应语言的上传位置
使用有站点设置权限的账号，进入 WordPress 后台「瓜奇」→主站「综合」→「语言设置」，展开要修改的语言。确认目标前端已启用这项语言；通过媒体库上传文件时，账号还需要上传权限。
| 字段 | 修改什么 | 留空时 |
|---|---|---|
| 自定义 JSON 语言包（可选） | 覆盖按钮、菜单、界面提示等译文，对应字段 json_file。 |
使用 Node 项目自带语言包。 |
| 服务端错误 JSON（可选） | 按已支持的错误码覆盖服务端提示，对应字段 error_json_file。 |
使用内置错误译文。 |
这两个字段都不会翻译文章正文、商品介绍或分类名称。那些内容需要在对应内容编辑入口处理。
修改界面文字
- 从对应语言的标准界面文件制作副本。后台语言设置说明中提供了中文标准语言包入口。
- 找到要修改的文字，只改译文，保留键名、层级结构和占位符。
- 检查文件是有效 JSON：使用英文双引号，不加注释，不在最后一项后多写逗号。
- 上传到该语言的「自定义 JSON 语言包」，保存配置。
- 打开目标前端的对应语言页面，检查一个明确修改过的按钮或提示。
自定义内容会与内置语言包合并，未覆盖的字段继续使用内置文字。运行时插件还可能提供自己的语言文字，因此修改某个键之前，应确认它确实是该界面使用的键。
修改服务端错误提示
- 在「服务端错误 JSON」字段说明中下载错误模板，不要拿普通界面语言包代替。
- 保留错误码，只修改对应的公开提示文字。保留
{limit}等占位符，名称和数量都要与模板一致。 - 保存为 JSON 对象，上传到目标语言的「服务端错误 JSON」。
- 保存配置，使前端服务读取并处理新文件。
- 在目标语言下重复触发一个已知错误，确认显示的是新文案。
占位符是显示时会替换成实际值的标记。例如模板中有 {limit}，修改后仍要保留它，不能改成中文键名或直接删除。
错误文件有哪些限制
- 整个文件不超过 256KB，最多包含 500 条错误文案。
- 顶层必须是对象，每个错误码对应一段字符串文字。
- 只能使用当前服务端认识的错误码。自行编一个错误码不会增加新错误类型，反而会导致校验失败。
- Node 会检查单条文字长度，要求不超过 2000 个字符；WordPress 还会检查单条 UTF-8 内容不超过 6000 字节。
- 不能加入 HTML 标签，占位符必须与该错误的定义一致。
不要把内部堆栈、密钥或上游服务原始响应写进面向访客的提示。文件过大、格式错误、未知错误码或占位符不匹配，都可能使配置更新失败，不能当作普通的“没有覆盖成功”。
替换文件和恢复默认
即使只替换了同一地址下的 JSON 文件，也要再次保存语言配置。仅上传新文件或刷新浏览器，不能代替配置更新。
恢复某条错误的默认文字，可以删除该错误码条目，或将它的文字设为空字符串。移除整个「服务端错误 JSON」配置，则恢复内置错误文案。完成后同样需要保存，并再次触发错误确认。
界面文字需要恢复默认时，移除相应覆盖项或清空自定义文件配置，再保存。错误语言包的“空文字恢复默认”规则不要直接套用到界面语言包。
文字没有变化时怎么检查
- 确认修改的是正确语言，目标前端也已启用该语言。
- 确认文件可被 WordPress 读取，内容是 JSON，而不是登录页、错误页或空文件。
- 确认已经保存配置；替换同地址文件后也要保存。
- 界面文字检查实际使用的键名；错误文字检查实际错误码是否受支持。
- 分别验证一个界面文字和一个可重复的服务端错误，不要用同一个结果判断两种文件都已生效。
错误语言包只作用于经过 Node 对应错误处理流程的响应。WordPress 后台直接返回的错误，不会因为前台语言切换就自动采用这份文件；不在当前错误目录中的提示，也不能靠新增自定义键完成接入。
单纯修改译文时，先保存并检查配置更新结果。若同时新增、删除或调整了启用语言，则还需要按语言配置要求重启对应前端 Node 服务。