Package Control未装好导致汉化失败,根本原因是其未加载进运行时环境;唯一验证方式是Ctrl+Shift+P输入Install Package能否调出命令,若提示command not found则说明底层管理器未启动,需重装Package Control并确保路径、脚本版本、网络配置全部正确。

Package Control 没装好,汉化根本走不下去
“安装路径汉化报错”90%不是汉化本身的问题,而是 Package Control 根本没加载成功——菜单里有“Package Control”选项、甚至能点开,不代表它真在工作。唯一有效验证方式:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Install Package。如果出现 Package Control: Install Package 命令,才算通过;若提示 command not found,说明底层插件管理器压根没启动。
常见失效原因包括:
- 安装时用了过期的 HTTP 地址(2026 年必须用
https://packagecontrol.io/) - 企业网络下
urllib.request.ProxyHandler()静默失败,控制台无报错但代码卡住 - 粘贴安装代码时多了一个空格或换行,导致语法错误
- 没彻底退出 Sublime 进程(Windows 托盘右键选 Exit,macOS 用 Activity Monitor 杀掉所有
subl进程)
ChineseLocalization 插件搜不到或装完没反应
不是网络慢,是 Package Control 的异步加载机制被误操作打断。输入 Package Control: Install Package 后必须等 2~3 秒,等新搜索框弹出(不是原命令面板),再在新框里精确输入 ChineseLocalization——注意 C 和 L 大写、末尾无 s,不能输成 ChineseLanguage 或 Localization。
装完界面仍是英文属正常现象,Sublime 不热重载 UI 语言层。关键下一步是手动加配置:
- 打开
Preferences → Settings — User(右侧文件,左侧只读) - 确保 JSON 合法:添加
"locale": "zh_CN",值必须用英文双引号,行末不能有多余逗号 - 保存后必须完全退出 Sublime(关窗口 ≠ 退出),再重开
字体乱码、繁简混杂、菜单显示“檔案”“編輯”
这不是翻译错了,是 Windows 上 DirectWrite 渲染引擎错误 fallback 到繁体字形表。改语言包、换汉化包都没用,必须强制切换渲染模式。
在 Preferences → Settings — User 中追加两行:
"font_options": ["gdi"], "gl_hardware_acceleration": false
其中 font_options 强制启用 GDI 渲染,绕过 DirectWrite;gl_hardware_acceleration 关闭硬件加速可缓解高 DPI 屏幕下的字体发虚或方块字。这两项不加,即使 locale 正确、插件已装,UI 仍可能显示异常。
Installed Packages 和 Packages 目录混放导致冲突
很多人把 ChineseLocalization.sublime-package 手动拖进 Packages 目录(即 Browse Packages 打开的位置),这是错的——正确位置是上一级的 Installed Packages 目录。混放会导致:
- 多个汉化包共存(如同时存在
ChineseLocalization.sublime-package和魔改版Default.sublime-package) - Cache 里残留旧翻译索引,菜单回退英文或显示乱码
- 重启后部分菜单中文、部分英文,且无法稳定复现
解决方法:彻底退出 Sublime 后,进入 Installed Packages 目录,只保留一个最新版汉化包(推荐官方 ChineseLocalization),其余全删;再进 Packages 目录,删掉整个 ChineseLocalization 文件夹(不是 .sublime-package 文件)和 Cache 目录(同级,非子目录)。
真正卡住的点往往不在“怎么装”,而在“装到哪”“什么时候生效”“谁在干扰渲染”。路径写错、进程没杀干净、JSON 多个逗号、字体渲染没关——这些细节一漏,前面所有操作都白搭。


















