Package Control 必须通过 Ctrl+` 打开控制台执行官方 Python 脚本安装,ST4 需版本 ≥4107 且脚本含 hashlib.sha256 校验,成功标志为状态栏显示“Successfully installed”,否则需手动下载 .sublime-package 文件拖入 Installed Packages 目录并重启验证。

Package Control 装不上?先确认控制台执行方式
Sublime Text 本身不带插件管理器,Package Control 必须手动安装,否则所有插件都装不了。常见失败不是因为代码错,而是执行入口不对。
别用菜单里“Preferences → Package Control”——这个选项只有装完后才出现。必须用 Ctrl+`(Tab 上方那个键)调出底部 Python 控制台,粘贴安装代码并回车。
- 如果快捷键被输入法拦截(比如 QQ 拼音),就去输入法设置里关掉“热键切换”
- 代码里域名已从
sublime.wbond.net切到packagecontrol.io,旧链接会超时或返回404 - ST4 用户必须用含
sha256校验的安装脚本,否则静默失败(无报错,但Installed Packages目录里没生成Package Control.sublime-package)
成功后不用重启,左下角短暂显示 “Package Control installed”,且 Preferences → Package Settings 下会出现 Package Control 项。
装插件卡在 “Installing…”?本质是网络不可达
按 Ctrl+Shift+P 输入 Install Package 后弹窗空白、长时间转圈,基本是网络问题,不是插件源挂了。
Package Control 默认走 HTTPS 请求 https://packagecontrol.io,国内直连不稳定。它不支持设置代理,也不能配置镜像源;科学上网是唯一可靠解法。
- 若无法科学上网,可手动下载插件 ZIP 包,解压到
Preferences → Browse Packages对应目录(如ChineseLocalization文件夹) - 插件名大小写敏感,比如
ConvertToUTF8写成converttoutf8就搜不到 - 等状态栏显示
Loading package list…(通常 2~3 秒)后再输入插件名,过早输入会导致搜索中断
中文界面始终不生效?三个硬性条件缺一不可
Sublime Text 4 的中文界面不是“装个汉化包”就能出来,必须同时满足:
-
Package Control正确加载(Ctrl+Shift+P输入Install Package能响应) -
ChineseLocalization插件成功安装(右下角显示Installed package ChineseLocalization) - 用户设置中写入
"locale": "zh_CN",且保存后彻底退出进程再重启(Windows 查托盘杀掉所有subl.exe,macOS 用 Activity Monitor 结束进程)
注意:"locale": "zh_CN" 必须写在 Preferences → Settings 右侧的 Preferences.sublime-settings — User 文件里;若该文件里已有 "ignored_packages": ["ChineseLocalization"],需删掉整行或移除该插件名。
Build System 和快捷键别混为一谈
很多人把插件快捷键和编译快捷键(比如 F5)当成一回事,结果改了 Key Bindings 却发现 C++ 不运行——其实是 Build System 没选对。
-
F5能否运行 C++,取决于是否已通过Tools → Build System → C++17手动选中编译系统 -
Key Bindings里写的"variant":"Run"是指Build System文件里的variants字段,不是插件命令 - 自定义快捷键如
{"keys":["f5"],"command":"build","args":{"variant":"Run"}}必须配合对应selector(如"source.c++")才生效
真正容易被忽略的是:插件功能依赖底层环境就绪。比如 ConvertToUTF8 只解决“打开乱码文件”,不改变保存编码;想存为 UTF-8 需手动选 File → Save with Encoding → UTF-8——配置和行为边界,比想象中更窄。

















