瓜奇
瓜奇
首页
瓜奇的优势
  • 为什么使用瓜奇夯
  • 瓜奇为什么快?
  • 瓜奇为什么安全?
  • 构建器介绍
安装瓜奇待完成
  • 开始
  • 环境准备
  • 前端规则
MCP使用教程
插件设置待补全
  • 智能搜索
  • 支付设置
  • AI设置
  • 物流设置
开发教程
  • 本地开发环境搭建
搜索
  • 首页
  • 产品中心优惠
  • 功能演示
  • 帮助中心
  • 插件中心新
  • 模板中心
  • 构建器非常夯
首页/文档/01 入门与基础/01.02 语言与货币/
打开 MD 链接

01.02.030 配置自定义界面和错误语言文案

发布于 1小时前
1

01 入门与基础 / 01.02 语言与货币

一、这个功能能做什么

「自定义 JSON 语言包」用于界面文字,「服务端错误 JSON」用于 Node 返回的已接入业务错误。两者在语言设置中分别上传,不能互换。

作用范围

Node 服务端按请求语言处理错误,浏览器只显示结果。但不能承诺全部旧接口或嵌套结果已接入:当前下载领取的嵌套错误链路仍有覆盖差异;WP 后台翻译按钮直接返回的错误也不能一概用 Node 字典解释。

某句没有变时,先确认发生在 WP 后台还是前台、具体错误码是否接入、目标语言与配置是否正确,再检查文件格式。界面切换语言不会自动翻译后台所有报错。

先认识这几个词

  • JSON:一种保存结构化文字数据的文件格式;修改时需要保持正确格式。
  • 占位符:发送或显示时自动替换的标记,例如用站点名称或当前订单号替换。
  • 前端:访客实际打开和使用的网站;同一后台可以对应多个前端网址。

逐项设置与效果

设置 功能与效果
界面语言包 使用自定义 JSON 文件覆盖适用界面文字
服务端错误语言包 配置对应语言的错误文案文件,按当前页面语言显示适用错误

二、设置后会有什么效果

你可以把界面中的默认文字改成更适合自己网站的说法,也可以调整已支持错误码的提示。界面文字与文章译文分别管理,修改按钮文案不会翻译文章正文。

三、怎么使用

界面文案

从对应语言标准文件制作副本,只修改译文,保留键名、结构和占位符。上传到该语言的「自定义 JSON 语言包」,保存配置后检查目标前端。留空使用 Node 项目自带语言包。

服务端错误文案

  1. 从后台提供的错误模板开始编辑。
  2. 按错误码修改允许公开的文字,保留 {limit} 等占位符。
  3. 文件不超过 256KB,上传到对应语言「服务端错误 JSON」。
  4. 保存配置;即使只替换了同地址文件,也需要再次保存。
  5. 在对应语言下触发已知错误,核对显示结果。

删除条目、空文字或移除自定义文件时,对已接入的错误恢复默认文案。不要将内部堆栈、密钥或上游原始响应写成客户提示。

完成配置并检查结果

在对应语言项分别配置界面 JSON 和错误文案文件,确认文件可读取且格式正确。保存语言配置后检查目标前端的页面文字和一个可重复的业务错误。替换同地址文件后仍要重新保存配置,触发前端更新。

四、常见问题

换了语言文件内容,页面为什么还是旧文字?

替换同地址文件后还需要重新保存对应配置,触发更新。先分清你改的是界面语言包还是服务端错误文件,再检查目标前端和语言。

更多使用问题

改了界面语言包,为什么错误提示没有改变?

界面文字和服务端错误使用不同配置。检查是否更新了正确的错误文案文件,以及该错误是否已接入对应翻译流程。

上一篇
01.02.020 设置货币与前端启用货币一、这个功能能做什么 货币池定义系统可用的币种,前端启用货币从池中选择。语言默认货币用于客户尚未选择币种时的默…
下一篇
01.03.010 保存配置后确认前台生效一、这个功能能做什么 保存配置后,应分别确认“后台已保存”和“目标前端已使用新配置”。前台还可能受语言、文章状…
所有的成功,都源自一个勇敢的开始
不辜负每一个勇敢的开始
关于帮助文档FAQ协议
瓜奇 © 2026鄂ICP备16020046号-7