package control真正生效的唯一标准是ctrl+shift+p输入“package control: list packages”能弹出列表;常见失效原因包括st4用户误用st3旧脚本、tls握手失败导致网络拦截、installed packages/目录存在旧版残留文件。

Package Control没装上,所有插件都白装
Sublime Text 自带的菜单里出现“Package Control”选项,不代表它能用。真正生效的唯一判断标准是:Ctrl+Shift+P 输入 Package Control: List Packages 能列出已安装插件列表——否则就是框架没跑起来。
常见失效原因有三个:
- 版本错配:ST4 用户用了 ST3 的旧脚本(比如含
sublime.wbond.net域名或 SHA256 校验值为eb2297e1...的),控制台静默失败,不报错也不弹提示 - 网络拦截:国内直连
packagecontrol.io时 TLS 握手失败,控制台卡在空白行,等满 5 秒无反应就得切手动方式 - 残留干扰:
Installed Packages/目录里留着旧版Package Control.sublime-package或带 “old” 字样的文件,会劫持命令通道,导致Install Package点击无响应
手动安装 Package Control 的硬性操作顺序
别拖进 Packages/ 目录,也别解压、改名、重命名——这三件事做错任何一个,Sublime 就认不出它。
必须严格按以下步骤执行:
- 关闭 Sublime Text 全进程(任务管理器里确认
subl.exe或Sublime Text进程已退出) - 菜单 →
Preferences → Browse Packages…→ 关闭窗口 → 向上退一级,进入Installed Packages/目录(不是Packages/!) - 清空该目录下所有含
Package Control字样的文件(包括Package Control.old、PackageControl.sublime-package等) - 浏览器访问
https://packagecontrol.io/Package%20Control.sublime-package,下载原始文件(注意 URL 中有空格编码%20) - 把下载好的
Package Control.sublime-package文件,直接拖入刚才清空的Installed Packages/目录(保持原名、不解压、不重命名) - 重启 Sublime Text,再试
Ctrl+Shift+P → Package Control: List Packages
插件装到一半卡在 “Installing…” 的真实原因
这不是插件源挂了,也不是你网速慢,而是 Package Control 根本没拿到响应体——它用的是 Python 的 urllib.request,不走系统代理,也不读 http_proxy 环境变量,更不支持配置镜像源。
所以遇到这种情况,只有两条路可走:
- 科学上网(全局模式,确保 Sublime 进程走代理通道)
- 放弃自动安装,手动下载 ZIP 包:
https://github.com///releases找 latest release 下载.zip,解压后整个文件夹扔进Packages/目录(如BracketHighlighter/),文件夹名必须和插件名完全一致(大小写敏感)
例如搜 ConvertToUTF8 装不上,手动下载后必须放进 Packages/ConvertToUTF8/,写成 converttoutf8 或 converttoutf8 都无效。
汉化、编码、括号高亮这三个插件的生效条件
它们看起来装完就该起效,但实际依赖具体配置项,漏掉一行设置等于白装。
-
ChineseLocalization:装完立即生效,但若界面仍是英文,说明Package Control没真正加载成功(验证方法同前);重装一次即可,无需重启 -
ConvertToUTF8:只解决“打开乱码文件”,不改变默认保存编码;想存为 UTF-8,必须手动点File → Save with Encoding → UTF-8,插件本身不接管保存行为 -
BracketHighlighter:默认只高亮匹配符号(如{}、[]),要显示竖线标识作用域范围,必须在用户设置里加这一行:"content_highlight_bar": true;不加,看起来就像没装
这些插件的设置文件路径统一为:Preferences → Package Settings → [插件名] → Settings – User,别改 Settings – Default,那会被覆盖。











