Package Control未真正就绪是插件安装失败主因,验证标准唯二:Ctrl+Shift+P执行List Packages能返回(哪怕空列表),且Install Package后状态栏显示Fetching list;ST4必须用官网installation.py脚本,执行后等5秒见“Successfully installed”提示才算成功。

装不上插件,八成不是插件问题,而是 Package Control 根本没通路——菜单里有选项、命令面板能搜到名字,都不代表它真能联网加载列表。
Ctrl+Shift+P 输入 Install Package 没反应?先验证 Package Control 是否真正就绪
别信“菜单出现”或“控制台没报错”,只认两个硬指标:
-
Package Control: List Packages能执行并返回(哪怕空列表) -
Package Control: Install Package执行后状态栏出现Loading packages或Fetching list of available packages - 若卡在命令面板关闭、控制台静默、左下角无任何提示,大概率是旧版残留劫持了命令通道——去
Installed Packages/目录删掉所有含Package Control字样的文件再重试
ST4 用户粘贴脚本后显示 “Success!” 却无法安装插件?版本和哈希值对不上
Sublime Text 4 必须用官网当前有效的 installation.py 脚本,旧版 ST3 脚本(哈希值以 6f4c264a 开头)在 ST4 上会静默失效:控制台显示成功,但 Install Package 命令不触发网络请求。
- 正确做法:按
Ctrl+`呼出控制台,一次性粘贴并执行官方最新脚本:import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 执行后必须等满 5 秒,看左下角是否弹出
Package Control: Successfully installed Package Control - 若只显示
reloading plugin就停住,基本是 TLS 握手失败或 DNS 污染,换手机热点重试最有效
插件列表一直卡在 “Fetching…”?packagecontrol.io 不支持代理和镜像
这不是插件源挂了,是 Sublime 的 Package Control 本身不读取系统代理、也不支持配置镜像地址。国内直连 https://packagecontrol.io 失败时,没有折中方案。
- 唯一可靠解法:科学上网(全局模式,非仅浏览器)
- 临时替代:手动下载插件 ZIP 包,解压后整体拖进
Packages/目录(注意不是Installed Packages/),文件夹名必须与插件名完全一致且大小写敏感(如ConvertToUTF8写成converttoutf8就不生效) - 验证连通性可在控制台执行:
urllib.request.urlopen('https://packagecontrol.io/').getcode(),返回200才算通
插件装完却不工作?语法作用域和路径放错是高频原因
插件不是放进目录就自动运行,它依赖当前文件的语法标识(scope)和加载路径是否合规。
- 右下角状态栏看当前语法:比如
Vue Syntax Highlight只在.vue文件或作用域为text.html.vue时生效,纯.html文件不会触发 - 路径必须严格:插件包
Emmet.sublime-package→ 放入Installed Packages/;解压后的Emmet/文件夹 → 整体拖入Packages/(不能套在子目录里) - 检查用户设置里
"ignored_packages"数组是否误写了插件名(如"Emmet"),会导致插件被主动禁用
最常被忽略的是:插件配置项(比如 BracketHighlighter 的 "content_highlight_bar": true)不写进设置文件,它就只是个摆设;而 ConvertToUTF8 仅解决打开乱码,保存编码仍需手动选 File → Save with Encoding → UTF-8。

















