Sublime Text 插件装不上90%因Package Control未真正运行;唯一有效判断是执行Install Package后左下角出现“Fetching list of available packages...”;ST4必须用官网以import urllib.request,os,hashlib;开头、域名为packagecontrol.io的脚本,旧脚本会导致静默失败。

Sublime Text 装不上插件,90% 是因为 Package Control 根本没真正跑起来——菜单里有选项、控制台显示“Success”、甚至 Preferences → Package Settings 里能看到条目,都不算数;唯一有效判断是:按 Ctrl+Shift+P 输入 Package Control: Install Package 后,左下角必须出现 Fetching list of available packages...。
确认 Sublime Text 版本再动手
ST4 和 ST3 的安装逻辑完全不同,混用脚本会导致静默失败。打开 Help → About Sublime Text,顶部明确显示【Sublime Text 4】才算 ST4。2026 年绝大多数用户用的是 ST4,但网上大量教程仍沿用 ST3 的哈希校验脚本(比如开头是 7183a2d3...),这类脚本在 ST4 上执行后控制台可能只打印 reloading plugin 就停住,Install Package 命令点不动、搜不到、或点开空白。
- ST4 必须用官网当前有效的单行脚本,以
import urllib.request,os,hashlib;开头,且域名是packagecontrol.io(不是旧的sublime.wbond.net) - 如果之前装过旧版,先手动清空
Installed Packages/目录下所有含Package Control字样的文件,否则残留会劫持命令通道 - 快捷键
Ctrl+`若被输入法拦截(如 QQ 拼音默认占用了),需进输入法设置关掉“热键切换”
Package Control 安装失败的两种可靠解法
控制台执行脚本失败,常见原因是网络超时、代理干扰或 SSL 证书问题。别反复重试,直接切备用路径:
-
方法一(推荐,需联网通畅):按
Ctrl+`呼出控制台,严格复制粘贴整段官网脚本(注意不要漏字符、不要带换行),回车后等满 5 秒——成功标志是控制台末尾为空行 + 左下角弹出Package Control: Successfully installed Package Control -
方法二(绕过网络):关闭 Sublime Text → 进入
Preferences → Browse Packages…→ 关闭窗口,向上退一级打开Installed Packages/目录 → 访问https://packagecontrol.io/Package%20Control.sublime-package下载该文件 → 直接拖入Installed Packages/(不改名、不解压、不放进Packages/)→ 重启编辑器
Install Package 卡在 “Fetching…” 怎么办
执行 Package Control: Install Package 后卡住,不是插件源挂了,而是本地连不通 packagecontrol.io。它不支持配置代理或镜像,也不读取系统环境变量里的 http_proxy,所以改设置无效。
- 公司/校园网常屏蔽该域名,换手机热点最直接;科学上网是唯一稳定解法
- 临时验证连通性:在控制台执行
urllib.request.urlopen('https://packagecontrol.io/').getcode(),返回200才算通 - 检查用户设置(
Preferences → Settings – User)里是否误写了空字符串的"http_proxy": ""或格式错误的代理配置,删掉即可 - 已安装但被忽略?确认
"ignored_packages"数组里没把想装的插件名(如"Emmet")写进去
插件装完不生效,优先查这三处
插件不是扔进目录就自动工作,加载依赖语法作用域、路径位置和配置项是否启用:
-
路径放错:
Emmet.sublime-package必须进Installed Packages/;而解压后的Emmet/文件夹必须整体拖进Packages/(不能嵌套进子目录,比如Packages/MyPlugins/Emmet/) -
语法不匹配:右下角状态栏看当前文件语法——
Vue Syntax Highlight只在.vue文件或作用域为text.html.vue时生效;纯.html文件不会触发,可手动按Ctrl+Shift+P输入Set Syntax: Vue测试 -
关键配置漏设:比如
BracketHighlighter默认只高亮括号,要显示竖线标识范围,必须在设置里加"content_highlight_bar": true;ConvertToUTF8只解决“打开乱码”,保存编码仍需手动选File → Save with Encoding → UTF-8
最常被忽略的其实是版本与脚本的精确对应——ST4 用户看到任何以 7183a2d3 或 eb2297e1 开头的安装代码,都该立刻跳过。时间花在核对版本和域名上,比反复重装高效得多。

















