Sublime Text 中文界面需分步实现:先正确安装 Package Control,再安装 ChineseLocalization 插件,接着在用户设置中配置 "locale": "zh_CN" 并重启,最后通过 Help → Language → 简体中文手动启用,但命令面板、报错等非 UI 内容不翻译。

Sublime Text 没有内置的“中文帮助文档”功能,官方 Help 菜单里所有内容始终是英文;所谓“安装中文帮助文档”,实际是指启用中文界面(菜单、设置项、对话框等)——它不提供 API 文档或教程翻译,只翻译 UI 字符串。
Package Control 没装好,后面全白忙
很多人卡在第一步:按 Ctrl + Shift + P 输入 Install Package,结果提示 command not found。这不是汉化失败,是插件管理器根本没加载。
- 必须先打开控制台(
Ctrl + `),粘贴当前有效的 HTTPS 安装代码(注意不是 HTTP) - 执行后要看到
Package Control installed或无报错输出,才算成功 - 装完必须彻底退出 Sublime:Windows 杀掉所有
subl.exe进程,macOS 用 Activity Monitor 结束Sublime Text进程,否则插件不初始化 - 重启后再次按
Ctrl + Shift + P,输入Install Package能完整看到Package Control: Install Package才算到位
ChineseLocalization 插件名一个字母都不能错
搜 ChineseLocalization 是唯一正确写法:C 和 L 大写,结尾是 n,中间无空格、无下划线、无 s(ChineseLocalizations 或 ChineseLanguage 都失败)。
- 确认
Package Control就位后,再执行Package Control: Install Package - 等底部状态栏显示
Loading package list…完成(通常 2~3 秒),新搜索框弹出后再输名字 - 方向键选中后回车,右下角出现
Installed package ChineseLocalization才算成功 - 装完界面不会变中文——这是 ST4 的设计,不是 bug,插件只提供翻译资源,不自动激活
"locale": "zh_CN" 必须写对位置和格式
这个配置必须写在 Preferences → Settings 右侧的 Preferences.sublime-settings — User 文件里,且 JSON 格式不能有一处错误。
- 不能写在左侧只读的默认设置里,也不能写在其他插件的配置文件中
- 必须用英文双引号,冒号后有空格,行尾不能有多余逗号
- 正确示例:
"locale": "zh_CN"(单独一行,放在大括号内已有配置的下方) - 写完保存,然后彻底退出 Sublime 再重开——仅关闭窗口或重载设置无效
Help → Language → 简体中文 这一步不能跳
即使 "locale": "zh_CN" 已写入并重启,部分 ST4 版本(如 build 4165+)仍需手动触发语言切换,否则菜单栏、右键项仍是英文。
- 点击顶部菜单
Help → Language → 简体中文,不是 Preferences 里的任意位置 - 如果该选项灰显,说明
ChineseLocalization插件未启用:进Preferences → Package Control → Enable Package确认勾选 - 部分版本首次点击
Help菜单时,Language子项需等待约 10 秒才渲染出来,别急着点空白处
真正容易被忽略的是:中文界面只覆盖固定 UI 字符串,命令面板(Ctrl + Shift + P)里的命令名、构建系统报错信息、第三方插件提示,这些都不会被翻译——它们本来就不在 ChineseLocalization 的翻译范围内。


















