sublime text 4 快速汉化并配好主题必须三步:安装 chineselocalization 插件、在用户设置中添加合法 json 格式 "locale": "zh_cn"、彻底退出进程后重启;任何双击安装包、替换 .lang 文件等操作均无效且危险。

Sublime Text 4 要快速汉化并配好主题,必须绕开所有“双击安装包”“替换 .lang 文件”“搜中文语言包”这类无效操作——它们要么失效,要么导致 UI 崩溃或插件管理器瘫痪。真正有效的路径只有一条:用 Package Control 装 ChineseLocalization,配 "locale": "zh_CN",再装主题插件,三步缺一不可。
怎么确认 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 年已被拦截) - 执行后输出
Package Control installed且无报错,才算完成;之后必须彻底退出 Sublime(Windows 杀掉所有subl.exe,macOS 用 Activity Monitor 结束进程),否则插件管理器不初始化
安装 ChineseLocalization 插件的三个硬性节奏点
不是网络慢,是 Package Control 的异步加载机制被频繁打断。失败主因全是人为节奏错乱:
- 输入
Package Control: Install Package后回车,**必须等 2~3 秒**,直到底部状态栏显示Loading package list…完成,新搜索框弹出,再动手输名字 - 在新搜索框中**精确输入
ChineseLocalization**:首字母C和L大写,结尾是n,无空格、无s、不能是ChineseLanguage或Localization - 方向键选中后回车,右下角出现
Installed package ChineseLocalization才算成功;仅显示Installing…不代表装完,Preferences → Package Settings里没这项说明插件未启用
为什么加了 "locale": "zh_CN" 还是英文?位置、格式、重启全要对
插件只提供翻译资源,不自动激活中文界面。这行配置必须同时满足三个条件才生效:
- 写在
Preferences > Settings右侧的Preferences.sublime-settings — User文件里;左侧默认设置是只读的,改了白搭 - JSON 格式必须合法:
"locale": "zh_CN"前后不能有多余逗号(尤其上一行末尾已有逗号时),引号必须是英文双引号,值必须用双引号包裹 - 保存后必须**完全退出 Sublime Text**(托盘图标右键“退出”,或任务管理器杀进程),再重新启动;只关窗口,设置根本不加载
装主题前先关硬件加速,否则字体发虚或方块字
很多用户装完主题发现中文模糊、菜单乱码,这不是汉化问题,是渲染层冲突。ST4 在高 DPI 屏或启用硬件加速时 fallback 到错误字体:
- 在
Preferences.sublime-settings — User中加一行:"gl_hardware_acceleration": false,可立刻缓解模糊或方块 - 中文字体建议显式指定:比如 Windows 加
"font_face": "Microsoft YaHei",macOS 用"font_face": "PingFang SC" - 主题推荐从
Package Control安装(如Material Theme或ayu),装完后通过Preferences → Color Scheme或Theme手动切换;别用拖拽解压方式,容易权限错乱
最易被忽略的点:所有配置修改后,必须彻底退出再重开;任何“热重载”“刷新菜单”“重载插件”都不触发 locale 或主题生效。这不是 bug,是 ST4 的设计逻辑——UI 语言和渲染层只在进程启动时读取一次设置。











