语言包:结构、键名与自制方法
一份语言包就是一张「键名 → 文案」的对照表。理解这一点,你就能自己改一版。
文件结构
本站语言包是 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 | 不生效(分隔符不符) |
自制一版:五步
- 取键名 从客户端当前版本导出键名列表,或以现有语言包为底稿。
- 翻译 只改值,不改键;同一术语全表统一,避免「设置/设定」混用。
- 校验 确认 UTF-8 无 BOM、JSON 合法、键名无重复。
- 托管 放到任意可公开访问的地址,纯文本,无需权限控制。
- 应用 在客户端的语言设置里导入,切换后检查三处界面。
五个常见的失败写法
| 错误 | 表现 |
|---|---|
| 文件带 BOM | 客户端拒绝解析,界面完全不变 |
| 缺逗号或多余逗号 | JSON 非法,导入报错或静默失败 |
| 键名拼错 | 该条目回落英文,其余正常 |
| 值里含未转义引号 | 解析中断,后续条目全部丢失 |
| 用 GBK 保存 | 中文显示为乱码方块 |
和「中文版客户端」的区别
语言包只替换文案,不改变程序;重打包的客户端则替换了整个安装包。前者出问题删掉即可,后者出问题涉及账号安全。判断与取舍见 关于「中文版」。