离线安装ChineseLocalization插件需将.sublime-package文件放入Packages目录并设"locale": "zh_CN"后彻底重启。必须确保路径正确、文件名大小写准确、无残留进程,三者缺一不可。

离线安装 ChineseLocalization 插件包
离线安装的核心是绕过 Package Control 的网络请求,直接把插件文件放进 Packages 目录。但注意:ChineseLocalization 不是“解压即用”的普通插件,它必须以 .sublime-package 文件形式存在,或以正确命名的文件夹结构放入 Packages(不是 Installed Packages)。
- 从 GitHub 或可信镜像下载最新版
ChineseLocalization.sublime-package(截至 2026 年 7 月,v3.4.1 是 ST4 兼容版本) - 打开 Sublime Text,菜单栏选
Preferences > Browse Packages,这会打开实际的Packages目录(路径类似~/Library/Application Support/Sublime Text 4/Packages或%APPDATA%\Sublime Text 4\Packages) - 把下载好的
ChineseLocalization.sublime-package文件直接拖入该目录(不要解压、不要放错位置) - 彻底退出 Sublime Text(macOS 用 Activity Monitor 杀掉所有
Sublime Text进程;Windows 在任务管理器中结束所有相关进程) - 重新启动,此时插件已加载,但界面仍为英文——这是正常现象,下一步才生效
必须手动设置 locale 才能显示中文
只装插件不写配置,等于白装。ChineseLocalization 插件本身不自动启用中文,它依赖用户设置里的 locale 字段触发翻译逻辑。
- 菜单栏打开
Preferences > Settings,右侧用户设置面板里添加一行:"locale": "zh_CN" - 保存后,**必须完全退出再重开**——仅关闭窗口或 Cmd+Q(macOS)可能残留后台进程,导致设置不加载
- 若仍为英文,检查是否误写成
zh-cn(小写)、zh_CN.UTF-8(多余后缀)或zh-Simplified(旧版兼容写法,ST4 已弃用) - 验证方式:打开命令面板
Cmd+Shift+P,输入Set Locale,看是否有中文选项出现;或观察菜单栏“Preferences”是否变成“首选项”
离线环境常见失败原因
离线安装失败,90% 不是插件问题,而是路径、权限或残留进程干扰。
-
Packages和Installed Packages容易混淆:前者用于手动放置插件文件夹或.sublime-package文件;后者仅由 Package Control 自动管理,放进去也不会被识别 - macOS 上如果用 Homebrew 或 dmg 安装的 ST4,
Packages路径可能在~/Library/Application Support/Sublime Text 4/Packages,而非安装包内嵌路径 - Windows 用户若装在 Program Files 下,可能因 UAC 权限导致复制失败——建议先复制到桌面,再拖入
Packages目录 - 插件名大小写敏感:
ChineseLocalization不能写成chineselocalization或ChineseLocalization-master(带 -master 后缀的解压文件夹无效)
验证汉化是否真正生效
别只看菜单栏变没变中文——很多用户卡在这一步,以为成功了,其实只是部分 UI 被缓存渲染,核心功能并未切换。
- 打开命令面板
Cmd+Shift+P,输入Package Control: List Packages,确认列表里有ChineseLocalization(不是灰色禁用状态) - 打开
Preferences > Package Settings > ChineseLocalization > Settings – User,看是否为空文件——非空说明插件已读取配置 - 新建一个空白文件,输入中文字符保存为 UTF-8 编码,观察右下角状态栏是否显示
UTF-8而非Undefined(这验证插件配套的编码支持模块是否加载) - 最关键的验证:打开
Preferences > Settings,删掉"locale": "zh_CN",重启,界面立刻切回英文;再加回去、重启,恢复中文——这才是闭环验证
locale 设置 + 插件文件 + 彻底重启三者同时满足。少一个,就停留在“看起来装好了”的假象里。


















