package control 真正安装成功的标志是:执行 package control: list packages 返回空列表,且 package control: install package 触发 fetching list of available packages;st4 必须使用哈希前缀为 6f4c264a 的官方脚本,手动安装需清空 installed packages/ 后拖入官网下载的 .sublime-package 文件。

Sublime Text 插件装不上,八成不是网络问题,而是 Package Control 根本没跑通——菜单里有选项、命令面板能搜到名字,都不算数,只认两个动作:Package Control: List Packages 能返回空列表,Package Control: Install Package 能触发 Fetching list of available packages。
怎么确认 Package Control 真装好了
别信菜单有没有“Package Control”项,它可能只是个空壳。真正生效的信号只有两个:
-
Ctrl+Shift+P输入Package Control: List Packages,执行后弹出一个空列表(不是报错,也不是卡住) -
Ctrl+Shift+P输入Package Control: Install Package,左下角立刻出现Fetching list of available packages...(哪怕卡住,也得先动起来) - 如果控制台里反复刷
reloading plugin却没后续,大概率是旧版残留文件劫持了命令通道,比如Package Control.py或带旧哈希名的.sublime-package文件还躺在Installed Packages/里
ST4 用户最常踩的安装坑
2026 年绝大多数人用的是 Sublime Text 4,但网上大量教程仍混用 ST3 脚本,导致静默失效——看起来成功,实际所有 Package Control 命令都点不动。
- 必须亲眼确认版本:Help → About Sublime Text,顶部显示的是
Sublime Text 4,不是Sublime Text 3或模糊的 “Build 4169” - ST4 官方推荐脚本哈希前缀是
6f4c264a,若你复制的脚本里h = 'eb2297e1...'或7183a2d3...,直接弃用 - 控制台执行后等满 5 秒再判断:末尾出现空行 + 左下角弹出
Package Control: Successfully installed Package Control才算真成功;只打印一行reloading plugin就停住,基本是 TLS 握手失败,换手机热点重试比调代理更可靠
插件装完不生效?先看这三处
插件不是拖进目录就自动工作,它依赖语法作用域、加载路径和配置状态。
- 右下角状态栏看当前文件的语法:比如
Emmet只在text.html或source.js作用域下触发,纯.txt文件不会补全 - 路径必须严格对应:
Emmet.sublime-package得扔进Installed Packages/;而解压后的Emmet/文件夹,必须整个拖进Packages/(不能套在子目录里) - 检查用户配置里是否误加了屏蔽项:打开
Preferences → Settings,右侧 JSON 中确认"ignored_packages"数组里没写"Emmet"、"GitGutter"这类名字
手动安装 Package Control 的硬核路径
当控制台脚本因网络或证书拦截失败时,手动方式反而更快更稳。
- 关闭 Sublime Text
- 菜单 →
Preferences → Browse Packages…→ 关闭窗口,往上退一级进到Installed Packages/目录 - 清空该目录下所有含
Package Control字样的文件(包括.py和.sublime-package) - 访问
https://packagecontrol.io/Package%20Control.sublime-package下载文件,直接拖进Installed Packages/(不改名、不解压、不放进Packages/) - 重启编辑器,再验证
List Packages是否可用
真正麻烦的从来不是“怎么装”,而是“为什么装了却像没装”——多数失效都卡在路径错位、作用域不匹配或旧文件残留上,而不是插件本身有问题。











