Sublime Text 4 中文界面需同时满足三个硬性条件：Package Control 正确加载、ChineseLocalization 插件成功安装、用户设置中添加合法 JSON 格式 "locale": "zh_CN" 并彻底退出进程后重启，缺一不可。
Package Control 装没装好，直接决定汉化成败
很多人卡在“点了 Install Package 却没反应”，其实根本不是汉化问题，而是 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 不会初始化
ChineseLocalization 插件安装必须精确匹配名称
搜错名字、输错大小写、没等列表加载就重输，是失败主因——不是网络慢，是 Package Control 的异步机制决定的。
在命令面板中输入 Package Control: Install Package 后，等底部状态栏显示 Loading package list… 完成（通常要 2~3 秒），再动手指；
- 在新弹出的搜索框中**精确输入 ChineseLocalization**：首字母 C 和 L 大写，结尾是 n，无空格、无 s，不是 ChineseLanguage 或 Localization
- 选中后回车，右下角出现 Installed package ChineseLocalization 才算成功；仅显示 Installing… 不代表完成
装完界面不会变中文——这是设计如此，ST4 不热重载 UI 语言层，不是 bug。
"locale": "zh_CN" 必须写对位置和格式
插件装完 ≠ 界面变中文。ST4 默认 fallback 到英文，必须手动指定才可靠，且这个配置极易写错位置或格式。
"locale": "zh_CN" 必须写在 Preferences > Settings 右侧的 Preferences.sublime-settings — User 文件里；左侧默认设置是只读的，改了也白搭。
- JSON 格式必须合法：前后不能多逗号（尤其上一行末尾已有逗号时），引号必须是英文双引号，值必须用双引号包裹（"zh_CN" 不是 zh_CN）
- 常见错误写法：zh-cn（小写）、zh_CN.UTF-8（多余后缀）、zh-Simplified（ST4 已弃用）
保存后，**必须完全退出再重开**——仅关闭窗口或 Cmd+Q（macOS）可能残留后台进程，导致设置不加载。
离线安装最容易踩的三个坑
离线安装的核心是绕过网络请求，直接把插件文件放进 Packages 目录，但路径、权限、进程残留三者缺一不可。
- 下载的必须是 ChineseLocalization.sublime-package 文件（截至 2026 年 7 月，v3.4.1 是 ST4 兼容版本），不要解压，不要放错目录
- Packages 和 Installed Packages 容易混淆：前者用于手动放置插件文件或 .sublime-package 文件；后者仅由 Package Control 自动管理，放进去也不会被识别
- Windows 若装在 Program Files 下，可能因 UAC 权限导致复制失败——建议先复制到桌面，再拖入 Packages 目录
最后验证方式：打开命令面板 Cmd+Shift+P，输入 Set Locale，看是否有中文选项出现；或观察菜单栏 Preferences 是否变成 首选项。任何“汉化包”“.lang 替换”操作均无效且危险，ST4 没有“语言包安装”这回事。
