语言包:结构、键名与自制方法

一份语言包就是一张「键名 → 文案」的对照表。理解这一点,你就能自己改一版。

文件结构

本站语言包是 UTF-8 编码的 JSON,只有四个顶层字段,没有脚本、样式或二进制内容。

字段含义示例
name语言显示名称简体中文(实验版)
version语言包自身版本0.1
updated最后更新日期2026-11-20
strings键名到文案的对照表见下
{
  "name": "简体中文",
  "version": "0.1",
  "updated": "2026-11-20",
  "strings": {
    "lng_settings": "设置",
    "lng_language": "语言",
    "lng_chat": "聊天"
  }
}

键名规则

键名由客户端定义,不是随便起的。常见前缀是 lng_,后面跟模块名,多数还可以加后缀区分单复数或状态。翻译时必须保持键名完全一致——大小写、下划线、后缀,差一个字符就静默失效。

写法结果
lng_settings正确
Lng_Settings不生效(大小写不符)
lng-setting不生效(分隔符不符)

自制一版:五步

  1. 取键名 从客户端当前版本导出键名列表,或以现有语言包为底稿。
  2. 翻译 只改值,不改键;同一术语全表统一,避免「设置/设定」混用。
  3. 校验 确认 UTF-8 无 BOM、JSON 合法、键名无重复。
  4. 托管 放到任意可公开访问的地址,纯文本,无需权限控制。
  5. 应用 在客户端的语言设置里导入,切换后检查三处界面。

五个常见的失败写法

错误表现
文件带 BOM客户端拒绝解析,界面完全不变
缺逗号或多余逗号JSON 非法,导入报错或静默失败
键名拼错该条目回落英文,其余正常
值里含未转义引号解析中断,后续条目全部丢失
用 GBK 保存中文显示为乱码方块

和「中文版客户端」的区别

语言包只替换文案,不改变程序;重打包的客户端则替换了整个安装包。前者出问题删掉即可,后者出问题涉及账号安全。判断与取舍见 关于「中文版」。