Package Control必须先装好且可响应命令,否则后续操作全无效;验证方式是按Ctrl+Shift+P输入Install Package,出现“Package Control: Install Package”才算到位,提示command not found说明未成功加载。

Package Control没装好,后续全白忙
手动安装中文语言包前,Package Control 必须已就位且可响应命令。很多人卡在“装了插件但没反应”,实际是 Package Control 根本没加载成功。
验证方法:按 Ctrl + Shift + P(Windows/Linux)或 Cmd + Shift + P(macOS),输入 Install Package —— 必须看到完整命令名 Package Control: Install Package 才算到位。如果提示 command not found,说明控制台里执行的安装代码失败或未重启。
- 2026 年起,官方只支持 HTTPS 地址:
https://packagecontrol.io/Package%20Control.sublime-package,HTTP 已被拦截 - 粘贴安装代码后,必须彻底退出 Sublime(Windows 杀掉所有
subl.exe,macOS 用 Activity Monitor 结束Sublime Text进程),否则插件管理器不初始化 - 控制台执行完无报错 ≠ 成功,要等右下角出现
Package Control installed或类似确认信息
ChineseLocalization 插件名大小写和拼写不能错
搜 ChineseLocalization 是唯一有效路径,不是 ChineseLocalizations、ChineseLanguage、Simplified Chinese Language,也不是带空格或下划线的变体。
安装流程必须严格遵循异步节奏:先输 Package Control: Install Package 回车 → 等状态栏显示 Loading package list… 完成(通常 2~3 秒)→ 再输 ChineseLocalization → 选中回车。
- 首字母
C和L必须大写,结尾是n,无复数s - 右下角出现
Installed package ChineseLocalization才算真正装上;仅显示Installing…不代表完成 - 装完界面不会自动变中文——这是设计行为,不是失败
"locale": "zh_CN" 必须写对位置和格式
"locale": "zh_CN" 这行配置必须加在用户设置文件里,也就是 Preferences > Settings 右侧那个 Preferences.sublime-settings — User 文件的大括号内部,不能写在左侧默认设置里(只读,改了无效)。
JSON 格式容错率极低,常见错误包括:上一行末尾多逗号、引号用了中文符号、漏掉冒号或双引号。
- 正确示例:
{"font_size": 12, "locale": "zh_CN"} - 错误示例:
{"locale": "zh_CN",}(末尾多余逗号)、{“locale”: “zh_CN”}(中文引号) - 保存后必须彻底退出 Sublime(关窗口 ≠ 退出进程),再重开才生效
Help → Language 菜单项有时不立即出现
部分 ST4.4+ 版本(如 build 4165)存在 UI 渲染延迟,重启后首次打开 Help 菜单时,Language 子项可能灰显或暂未渲染,等约 10 秒再点通常就出来了。
若该菜单项始终不出现,检查 Preferences > Package Settings > ChineseLocalization 是否存在 —— 不存在说明插件未启用,可能是安装路径异常或被企业代理拦截。
- 企业网络环境下,
urllib.request.ProxyHandler()可能失效,建议临时关闭代理,或离线下载ChineseLocalization.sublime-package手动丢进Installed Packages目录 - 汉化范围有限:命令面板里的第三方插件命令名、构建错误堆栈、终端输出等内容不会被翻译,这不是配置问题,是插件能力边界
Package Control 没活过来、locale 配错了位置、或者进程根本没退干净。


















