package control真正生效的唯一标准是ctrl+shift+p执行package control: list packages返回空列表且package control: install package触发fetching list of available packages;st4必须用官网installation.py脚本或手动拖入package control.sublime-package至installed packages/目录,旧脚本混用会静默失效。

Sublime Text 插件安装不靠“拖文件”或“一键包”,靠的是 Package Control 通道是否真正打通——它不是菜单里有个名字就叫“装好了”,而是 Package Control: Install Package 能触发 Fetching list of available packages,且 Package Control: List Packages 返回空列表(不是报错)才算过关。
确认 Sublime Text 版本再动手
ST4 和 ST3 的 Package Control 安装脚本哈希值不同,混用必废。打开 Help → About Sublime Text,亲眼确认顶部显示的是 Sublime Text 4 还是 Sublime Text 3。别凭印象、别看文件名、别信旧教程截图——2026 年绝大多数人用的是 ST4,而 ST4 必须用官网 installation.py 或手动拖入 Package Control.sublime-package,旧版脚本(比如哈希以 6f4c264a 开头的)在 ST4 上会静默失效:命令面板能搜到条目,但点不动、不加载、控制台无输出。
绕过网络失败的手动安装法
控制台执行脚本卡在 reloading plugin 或根本没反应?说明网络被拦截(公司/校园网常见)、TLS 握手失败,或代理配置错误。此时别反复重试,直接切手动:
- 关闭 Sublime Text
- 菜单 Preferences → Browse Packages… → 关闭窗口,向上退一级进
Installed Packages/目录 - 清空该目录下所有含
Package Control字样的文件(旧残留会劫持命令) - 访问
https://packagecontrol.io/Package%20Control.sublime-package下载文件 - 把下载好的
Package Control.sublime-package文件直接拖进Installed Packages/(不要解压、不要改名、不要放进Packages/目录) - 重启编辑器
验证通道是否真通
别信菜单有没有选项,只认两个硬指标:
- 按
Ctrl+Shift+P输入Package Control: List Packages→ 能执行并返回空列表(不是报错) - 输入
Package Control: Install Package→ 左下角出现Fetching list of available packages文字(首次约 5–10 秒)
若卡在 Fetching… 超 30 秒,检查用户配置里是否有非法 "http_proxy" 值(比如空字符串),或临时在控制台执行:urllib.request.urlopen('https://packagecontrol.io/').getcode(),返回 200 才算通。
插件装完却不生效?先看语法作用域
插件不是复制进目录就自动工作。比如 Emmet 只在 text.html 或 source.css 作用域下触发;Vue Syntax Highlight 只对 .vue 文件或作用域为 text.html.vue 生效。右下角状态栏显示的语法名称就是当前作用域,不匹配就不起作用。
- 手动切换语法:
Ctrl+Shift+P输入Set Syntax: Vue看是否立刻高亮 - 路径必须严格:
Emmet.sublime-package放Installed Packages/;解压版Emmet/文件夹整体放Packages/(不能嵌套进子目录) - 检查
ignored_packages配置项,确认没把刚装的插件名写进去(如"Emmet")
最常被忽略的其实是作用域匹配——很多人以为装完就能用,结果在纯 .html 文件里等 Emmet 展开,永远等不到。











