语言包不生效的六个原因
按顺序排查,每条都给出判断依据,不需要反复试。
语言包导入后界面没变,通常不是文件本身坏了,而是六个环节中的一个出了问题。下面按「最常见 → 最少见」排序,前两个能覆盖大部分情况。
1. 只是下载了,没有应用
语言包是文本文件,下载到本地不会自动生效。它需要被「应用」一次:要么通过语言包链接在客户端内打开,要么在设置的语言列表里添加。判断方法:设置 → 语言里如果看不到新增的中文条目,说明从未应用过。
2. 应用了旧版本
语言包带版本号。如果你应用的是几个月前的文件,而客户端已经更新过若干次,新增的文案就没有对应条目,表现是「大部分中文、部分新功能还是英文」。判断方法:对比 更新日志 里最新版本与你手上的文件名。
3. 客户端版本过旧
语言包依赖客户端提供的键名。客户端太旧,可能不认识新键名,表现是部分条目空白或回落英文。判断方法:设置里查看版本号,与官方最新版对比;能直接更新的先更新。
4. 文件编码或格式错误
语言包必须是 UTF-8 且为合法 JSON。用记事本另存时容易带上 BOM(字节顺序标记),部分客户端会直接拒绝解析。判断方法:用浏览器打开文件,如果不显示为结构化文本而是乱码,说明编码不对。
# 检查是否带 BOM(前三个字节应为 EF BB BF 之外的内容)
xxd -l 3 tg-zh-hans-v0.1.json
# 验证 JSON 合法性
python -c "import json,sys;json.load(open('tg-zh-hans-v0.1.json',encoding='utf-8-sig'));print('ok')"
5. 键名不匹配
每个文案对应一个内部键名,键名写错就会静默跳过——不报错,也不生效。判断方法:把文件里的键名与客户端当前版本的键名对照;改动过的键名要跟着客户端更新走。
键名规则与常见错误列表见 语言包说明。
6. 账号语言覆盖
语言是账号级设置。你在 A 设备上切换到中文,B 设备可能仍是原语言;反之,某台设备上的旧设置也可能把新语言包覆盖回去。判断方法:在出问题的那台设备上重新进入设置 → 语言,手动再选一次中文。
排查时该收集哪些信息
| 项目 | 在哪看 | 用途 |
|---|---|---|
| 客户端版本号 | 设置 → 关于 / 帮助 | 判断是否版本过旧 |
| 操作系统与版本 | 系统设置 | 区分系统菜单问题 |
| 语言包版本 | 文件名或文件内 version 字段 | 判断是否旧包 |
| 现象截图 | — | 定位是局部还是全局未生效 |
四项齐全,基本能一次定位。缺任何一项,都只能靠试。