sublime text 4 汉化需同时满足三条件:正确安装 package control(通过 ctrl+shift+p 输入 install package 验证)、精确安装 chineselocalization 插件(等加载完成后再输入,c 和 l 大写、无 s)、在用户设置 preferences.sublime-settings — user 中添加合法 json 格式 "locale": "zh_cn" 并彻底退出进程后重启。

Package Control没装好,后面全白搭。Sublime Text 4 根本不认“中文包”这种东西,所谓汉化就是三件事:装对插件、写对配置、杀干净进程——少一个,界面就卡在英文。
怎么验证 Package Control 真装好了?
菜单里有“Package Control”选项 ≠ 它能用。真正有效的判断只有一条:Ctrl + Shift + P(Windows/Linux)或 Cmd + Shift + P(macOS)调出命令面板,输入 Install Package —— 必须看到完整命令名 Package Control: Install Package 才算到位。
如果提示 command not found,说明根本没加载。此时要:
- 按 Ctrl + ` 打开控制台
- 粘贴官网最新 HTTPS 安装代码(HTTP 地址在 2026 年已被拦截):import urllib.request,os; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); open(os.path.join(ipp, pf), 'wb').write(urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read())
- 执行后无报错,再彻底退出 Sublime(Windows 杀掉所有 subl.exe,macOS 用 Activity Monitor 结束所有 Sublime Text 进程),否则插件管理器压根不初始化
ChineseLocalization 插件必须精确安装
搜 ChineseLocalization 是唯一有效路径,不是 ChineseLanguage、不是 Localization、也不是 ChineseLocalizations(结尾多一个 s 就失败)。大小写敏感:C 和 L 必须大写,中间无空格,无标点。
操作节奏不能抢:
- 先确认 Package Control 就位,再按 Ctrl + Shift + P 输入 Package Control: Install Package 回车
- 等底部状态栏显示 Loading package list…(通常 2~3 秒),等新搜索框弹出后再动手
- 在新框中精确输入 ChineseLocalization,方向键选中,回车
- 右下角出现 Installed package ChineseLocalization 才算成功;仅显示 Installing… 不代表完成
"locale": "zh_CN" 必须写对位置和格式
插件装完 ≠ 界面变中文。ST4 不热重载 UI 语言层,这行配置是开关,但极易写错:
- 只能写在 Preferences > Settings 右侧的 Preferences.sublime-settings — User 文件里;左侧默认设置是只读的,改了也白搭
- JSON 格式必须合法:"locale": "zh_CN" 前后不能多逗号(尤其上一行末尾已有逗号时),引号必须是英文双引号,值必须用双引号包裹("zh_CN" 不是 zh_CN)
- 保存后必须完全退出 Sublime(关窗口 ≠ 退出),再重开;否则设置根本不加载
- 别写成 zh-cn(小写)、zh_CN.UTF-8(多余后缀)或 zh-Simplified(ST4 已弃用)
字体发虚、菜单乱码怎么办?
这不是汉化失败,是渲染层问题。高 DPI 屏幕或启用硬件加速时,ST4 容易 fallback 到错误字体链:
- 在用户设置里加一行:"gl_hardware_acceleration": false,能立刻缓解模糊或方块字
- 乱码常因系统缺失中文字体:
• Windows 用户可试 "font_face": "Microsoft YaHei"
• macOS 用户优先用 "font_face": "PingFang SC"
• Linux 用户建议用 "font_face": "Noto Sans CJK SC"
- 某些 UI 插件(如 Origami、BracketHighlighter)会干扰 locale 解析,临时禁用可快速验证是否冲突
真正卡住人的地方从来不是插件名输错,而是 "locale" 写在了只读的默认设置里、JSON 多了个逗号、或者以为关了窗口就算退出——后台进程还在,配置压根没加载。











