一、这个功能能做什么
「自定义 JSON 语言包」用于界面文字,「服务端错误 JSON」用于 Node 返回的已接入业务错误。两者在语言设置中分别上传,不能互换。
作用范围
Node 服务端按请求语言处理错误,浏览器只显示结果。但不能承诺全部旧接口或嵌套结果已接入:当前下载领取的嵌套错误链路仍有覆盖差异;WP 后台翻译按钮直接返回的错误也不能一概用 Node 字典解释。
某句没有变时,先确认发生在 WP 后台还是前台、具体错误码是否接入、目标语言与配置是否正确,再检查文件格式。界面切换语言不会自动翻译后台所有报错。
先认识这几个词
- JSON:一种保存结构化文字数据的文件格式;修改时需要保持正确格式。
- 占位符:发送或显示时自动替换的标记,例如用站点名称或当前订单号替换。
- 前端:访客实际打开和使用的网站;同一后台可以对应多个前端网址。
逐项设置与效果
| 设置 | 功能与效果 |
|---|---|
| 界面语言包 | 使用自定义 JSON 文件覆盖适用界面文字 |
| 服务端错误语言包 | 配置对应语言的错误文案文件,按当前页面语言显示适用错误 |
二、设置后会有什么效果
你可以把界面中的默认文字改成更适合自己网站的说法,也可以调整已支持错误码的提示。界面文字与文章译文分别管理,修改按钮文案不会翻译文章正文。
三、怎么使用
界面文案
从对应语言标准文件制作副本,只修改译文,保留键名、结构和占位符。上传到该语言的「自定义 JSON 语言包」,保存配置后检查目标前端。留空使用 Node 项目自带语言包。
服务端错误文案
- 从后台提供的错误模板开始编辑。
- 按错误码修改允许公开的文字,保留
{limit}等占位符。 - 文件不超过 256KB,上传到对应语言「服务端错误 JSON」。
- 保存配置;即使只替换了同地址文件,也需要再次保存。
- 在对应语言下触发已知错误,核对显示结果。
删除条目、空文字或移除自定义文件时,对已接入的错误恢复默认文案。不要将内部堆栈、密钥或上游原始响应写成客户提示。
完成配置并检查结果
在对应语言项分别配置界面 JSON 和错误文案文件,确认文件可读取且格式正确。保存语言配置后检查目标前端的页面文字和一个可重复的业务错误。替换同地址文件后仍要重新保存配置,触发前端更新。
四、常见问题
换了语言文件内容,页面为什么还是旧文字?
替换同地址文件后还需要重新保存对应配置,触发更新。先分清你改的是界面语言包还是服务端错误文件,再检查目标前端和语言。
更多使用问题
改了界面语言包,为什么错误提示没有改变?
界面文字和服务端错误使用不同配置。检查是否更新了正确的错误文案文件,以及该错误是否已接入对应翻译流程。