package control未装好则后续操作无效;唯一有效验证是命令面板输入“package control: install package”并成功执行,否则需重装。

Package Control 没装好,后面所有操作都白搭——界面不会变中文,不是插件问题,是根本没走通安装链路。
确认 Package Control 是否真正就位
很多人点开命令面板输 Install Package 看到提示就以为装好了,其实只是“命令存在”,不代表插件管理器已加载成功。
真正有效的验证方式只有一种:Ctrl + Shift + P(Windows/Linux)或 Cmd + Shift + P(macOS)打开命令面板,输入 Package Control: Install Package —— 如果能直接选中并执行,说明已就绪;如果提示 “command not found”,就得重装。
- 手动安装失败最常见原因:
urllib.request.ProxyHandler()在企业网络/代理下失效;粘贴时多出空格;用了过期的 HTTP 地址(2026 年必须用https://packagecontrol.io/) - 装完必须彻底退出 Sublime Text:Windows 查任务管理器杀掉
subl.exe,macOS 用 Activity Monitor 找Sublime Text进程,关窗口 ≠ 退出进程 - 控制台报错
invalid syntax?大概率是复制时混入了全角字符或换行符,建议用纯文本编辑器中转一次再粘贴
安装 ChineseLocalization 插件时别输错名字
搜 ChineseLanguage、Localization、chinese localization 都找不到——它严格区分大小写和拼写,唯一有效名称是 ChineseLocalization(C 大写,L 大写,末尾无 s)。
- 命令面板输入
Install Package→ 回车 → 等 2~3 秒,等新搜索框弹出再输,别急着重打(Package Control 是异步加载列表) - 右下角出现
Installed package ChineseLocalization才算成功;如果没提示,大概率是搜错了或网络中断 - 装完界面不立刻变中文是正常行为,不是失败。ST 不热重载 UI 语言层,重启前看到英文完全合理
"locale": "zh_CN" 必须写对位置、格式、时机
这是绝大多数人卡住的第二步:插件装了,设置也加了,但还是英文——因为三个硬性条件缺一不可。
- 只在
Preferences → Settings的右侧(Preferences.sublime-settings — User)里添加,左侧默认设置是只读的,改了也无效 - JSON 格式必须合法:
"locale": "zh_CN"前后不能少引号,行末不能有多余逗号(尤其当你复制整段 JSON 覆盖时容易带进去) - 保存后必须彻底退出再重开,托盘图标右键“退出”、macOS 强制退出、Windows 结束进程,关窗口不算
- 某些 UI 插件(如
Origami、BracketHighlighter)会干扰 locale 加载,临时禁用可快速验证是否冲突
中文显示异常?先关 gl_hardware_acceleration
菜单字体发虚、出现方块、部分文字乱码,通常不是汉化失败,而是渲染层 fallback 出错。
- 高 DPI 屏幕或启用了硬件加速时,ST4 的中文字体渲染容易失真,加一行
"gl_hardware_acceleration": false到用户设置里,多数能立刻缓解 - 仍乱码?检查系统是否缺失基础中文字体:Windows 可试加
"font_face": "Microsoft YaHei",macOS 用"font_face": "PingFang SC" - 切回英文不用卸插件:命令面板输
Localization: Choose Language→ 选English即刻生效,比删配置更干净











