Sublime Text 菜单/主题中文显示为方块或英文,主因是未正确配置 font_face 及系统 locale,而非汉化包失效;需按系统指定支持中文的字体、校准区域设置,并清除缓存强制重载 UI 资源。

汉化后菜单/主题文字变方块或显示英文
这不是汉化包失效,而是 Sublime Text 没启用中文渲染管线。ST3.3+ 和 ST4 默认跳过中文字体回退逻辑,即使装了汉化包、改了语言设置,只要 font_face 未显式指定支持中文的字体,菜单、侧边栏、状态栏等 UI 元素就会 fallback 到系统默认无中文字形的字体(如 Consolas),结果就是 □□□ 或直接回退成英文。
- Windows 用户必须在
Preferences → Settings–User中硬写"font_face": "Microsoft YaHei"(不能只写"font_face": "微软雅黑") - macOS 用户需用系统内置名称:
"font_face": "PingFang SC, Hiragino Sans GB",且确保locale输出含UTF-8(执行locale | grep UTF-8验证) - 别把
font_face写成列表形式(如["Microsoft YaHei", "Consolas"])——ST 不支持多字体 fallback,只取第一个 - 如果用了第三方主题(如 Material Theme),它可能覆盖了你的
font_face设置,得去该主题的.sublime-theme文件里手动补上"font.face"字段
右下角编码显示正常但菜单仍是乱码
说明文件编码和 UI 渲染是两套机制,别被“当前文件能显示中文”误导。菜单乱码只和字体 + 系统 locale + ST 内部渲染引擎有关,和 fallback_encoding 或 default_encoding 完全无关。
- ST4 已移除对
fallback_encoding的支持,写它进去纯属无效配置;菜单乱码时检查这个字段毫无意义 - Windows 上若已设
font_face仍乱码,进控制面板 → 区域 → 管理 → “非 Unicode 程序的语言” 必须设为“中文(简体,中国)”,否则 Core Text 渲染层不加载中文字形 - macOS 上运行
defaults write -g AppleLocale "zh_CN@utf-8"并重启 Finder 和 ST,可强制 Core Text 启用简体中文字形集
汉化包更新后菜单突然变英文
大概率是汉化包替换了 Default.sublime-package 里的二进制资源,但没同步更新 ST 的语言环境缓存。ST 不会自动 reload UI 资源,尤其在热更汉化包后。
- 不要手动解压或编辑
Default.sublime-package——它是签名包,修改后 ST 会拒绝加载并静默回退到英文 - 正确做法:关闭所有 ST 实例 → 删除
Cache/Default/目录(路径见Preferences → Browse Packages…上级目录)→ 重开 ST - 若用的是第三方汉化插件(如 ChineseLocalization),检查其设置里是否勾选了“禁用自动语言检测”——开启后 ST 才会强制走汉化资源,否则仍按系统 locale 动态判断
字体设对了但某些图标或符号还是乱码
这是字体本身缺字型,不是编码问题。比如 Microsoft YaHei 不包含 FontAwesome 图标、NERD Fonts 补丁符号、或某些 Unicode 14.0 新增汉字(如“?”),渲染时就会 fallback 成 □ 或空格。
- 优先换用全字符集字体:Windows 推荐
"font_face": "Microsoft JhengHei UI"(比 YaHei 多支持 2000+ CJK 统一汉字) - macOS 可试
"font_face": "SF Pro Display, PingFang SC",SF Pro 对 emoji 和新汉字兼容性更好 - 别指望靠
font_options修复缺字——["directwrite"]或["subpixel_antialias"]只影响渲染平滑度,不补充字形 - 若主题用了自定义 icon font(如 Octicons),确认该字体文件已安装到系统字体目录,且主题 JSON 里
"font.face"指向的是那个字体名,不是系统默认字体


















