sublime text 4汉化需三步：安装package control、精确安装chineselocalization插件、在用户设置中添加合法json格式"locale": "zh_cn"并彻底退出重启。
Package Control没装好，所有汉化操作都白搭
界面还是英文、命令面板搜不到Install Package、右下角从不弹出插件安装成功提示——90% 是因为 Package Control 根本没加载成功，不是汉化包的问题。
验证方式只有一种：Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux），输入 Install Package。如果出现完整命令 Package Control: Install Package，才算到位；如果提示 command not found，说明插件管理器压根没初始化。
- 控制台（
Ctrl + `）粘贴的安装代码必须用 HTTPS 地址：https://packagecontrol.io/Package%20Control.sublime-package，HTTP 已被拦截 - 粘贴后必须彻底退出 Sublime Text（macOS 用 Activity Monitor 结束
Sublime Text进程；Windows 结束所有subl.exe），否则插件管理器不会启动 - 企业网络环境下，
urllib.request.ProxyHandler()常失效，可尝试关闭代理或手动下载Package Control.sublime-package放入Installed Packages目录
ChineseLocalization 插件名输错，安装静默失败
搜 ChineseLanguage、Localization、zh_CN Lang 都不行，这些要么是旧版、要么不维护，装了会导致菜单空白或崩溃。
唯一有效名称是：ChineseLocalization，大小写敏感、无空格、末尾无 s。
- 必须先执行
Package Control: Install Package→ 等底部状态栏显示Loading package list…完成（通常 2~3 秒），再输入名字 - 在新弹出的搜索框里输入，不是在第一个命令面板里直接打
- 选中后回车，右下角出现
Installed package ChineseLocalization才算成功；仅显示Installing…不代表完成
"locale": "zh_CN" 写错位置或格式，界面死活不变中文
装完插件，界面仍是英文？不是插件没起作用，是 ST4 默认 fallback 到英文，必须显式指定语言且配置合法。
"locale": "zh_CN" 必须同时满足三个硬条件：
- 写在
Preferences > Settings右侧的Preferences.sublime-settings — User文件里，左侧默认设置是只读的，改了无效 - JSON 格式必须合法：前后不能多逗号（尤其上一行末尾已有逗号时）、引号必须是英文双引号、值必须包裹在双引号内（
"zh_CN"不是zh_CN） - 保存后必须彻底退出 Sublime Text（关窗口 ≠ 退出），再重开；否则设置完全不加载
中文错误框显示方块字或模糊，其实是渲染层问题
菜单变中文了，但弹出的错误提示框全是方块、字体发虚、文字挤在一起——这不是汉化失败，是 ST4 渲染时 fallback 到了不支持中文的字体或启用了异常硬件加速。
- 在用户设置里加一行：
"gl_hardware_acceleration": false，能立刻缓解字体模糊或方块 - Windows 可试加：
"font_face": "Microsoft YaHei"；macOS 推荐："font_face": "PingFang SC" - 某些 UI 插件（如
Origami、BracketHighlighter）会干扰 locale 解析，临时禁用可快速验证是否冲突
locale 写在只读的默认设置里，或者以为关掉窗口就算重启，结果插件根本没加载。这些细节不踩一遍坑，很难意识到它们才是关键。
