语言包不生效的六个原因

按顺序排查,每条都给出判断依据,不需要反复试。

语言包导入后界面没变,通常不是文件本身坏了,而是六个环节中的一个出了问题。下面按「最常见 → 最少见」排序,前两个能覆盖大部分情况。

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 字段判断是否旧包
现象截图—定位是局部还是全局未生效

四项齐全,基本能一次定位。缺任何一项,都只能靠试。