菜单乱码主因是系统字体缺失或Sublime未声明中文字体,与汉化包是否生效基本无关;Windows需确认安装微软雅黑Regular并显式设置"font_face": "Microsoft YaHei",macOS/Linux需确保locale为UTF-8且从终端启动,切勿手动解压修改Default.sublime-package。

菜单显示乱码,和汉化包是否生效基本无关,90% 是系统字体缺失或 Sublime 渲染链路没声明中文字体导致的回退失败。
Windows 下菜单乱码:微软雅黑没装或没启用
Sublime 不会自动选系统中文字体,必须显式指定。即使你装了汉化包,font_face 没设对,菜单资源加载后仍会 fallback 到无中文支持的字体(比如 Courier New),结果就是方块或空白。
- 确认控制面板 → 字体里存在
Microsoft YaHei(微软雅黑)——不是“微软雅黑 Bold”或“Light”,要带“Regular”字样的主字体 - 打开
Preferences → Settings–User,确保有这一行:"font_face": "Microsoft YaHei" - 删掉配置里任何
"font_face": "Consolas"或"font_face": "Monaco"这类纯英文字体声明,它们会覆盖中文字体 - 改完保存,**必须重启 Sublime**(仅重载设置不生效)
macOS/Linux 下菜单乱码:locale 编码不是 UTF-8
Sublime 的菜单资源是 Unicode 字符串,但底层渲染依赖系统 locale。如果 LANG 是 en_US.ISO8859-1 这类非 UTF-8 值,Core Text 或 Pango 就可能把中文字符当非法字节丢弃。
- 终端执行:
locale | grep -E "(LANG|LC_ALL)",输出里必须含UTF-8,例如LANG=zh_CN.UTF-8或LANG=en_US.UTF-8 - 若不含 UTF-8,在
~/.zshrc或~/.bash_profile末尾加:export LANG=en_US.UTF-8(macOS 推荐zh_CN.UTF-8) - 执行
source ~/.zshrc后,再从终端启动 Sublime:open -a "Sublime Text"(macOS)或subl(Linux),不能直接点图标——否则继承的是 GUI 环境的旧 locale
汉化包替换错位置:Default.sublime-package 被手动解压修改
ST3.3+ 把菜单资源编译进 Packages/Default.sublime-package 这个 zip 包里,不是 JSON 文件。有人解压它、改 menu_en.json、再打包回去,结果 zip 结构损坏或资源路径错位,菜单直接不加载,回退成英文。
- 别碰
.sublime-package文件本身——它是只读运行时包,强行修改极易破坏 CRC 校验 - 正确做法是用社区维护的 SublimeText-Localization 项目,按说明替换整个
Default.sublime-package文件(不是里面的内容) - 替换后检查
Packages/目录下有没有多出一个叫Default的文件夹——如果有,说明你解压了包但没删原包,Sublime 会优先加载文件夹,而它不含汉化资源
最常被忽略的一点:菜单乱码和文件内容乱码是两套机制。前者卡在字体 + locale + 资源包三层,后者才涉及 fallback_encoding 和编码识别。修菜单时,别去动用户设置里的编码字段,那对菜单渲染完全无效。











