Package Control未装上则所有插件安装均无效;必须通过Ctrl+`控制台执行官方脚本,且唯一生效标志是Ctrl+Shift+P中能执行Package Control: List Packages并显示空列表,以及执行Install Package后状态栏出现Fetching list of available packages。

Package Control 没装上,后面所有插件都白装——不是菜单里有“Package Control”就代表能用,而是必须能执行 Package Control: Install Package 并触发 Fetching list of available packages。
Ctrl+` 控制台才是唯一安装入口
Sublime Text 本身不带包管理器,Package Control 必须手动注入 Python 运行时。菜单里 “Preferences → Package Control” 是假象,那个选项只有装完才该出现;点它只会报错或静默失败。
- 必须按
Ctrl+`(Tab 上方那个键)呼出底部控制台,粘贴官方脚本并回车 - 若快捷键被输入法拦截(如 QQ 拼音默认占用了
Ctrl+`),需进输入法设置关掉“热键切换” - ST4 用户严禁复用 ST3 脚本:旧脚本哈希值以
eb2297e1或6f4c264a开头,而 ST4 要求从https://packagecontrol.io/installation.py动态加载,否则控制台显示Success!但后续所有命令失效
装完没反应?只认两个硬指标
左下角弹出 Package Control installed 不够,重启也不够。真正生效的标志只有两个:
-
Ctrl+Shift+P输入Package Control: List Packages→ 能执行并返回空列表(不是报错) -
Ctrl+Shift+P输入Package Control: Install Package→ 状态栏立刻显示Fetching list of available packages(哪怕卡住,也得先动起来) - 若命令面板搜得到但点不动、或控制台只打印
reloading plugin就停住,大概率是残留旧版Package Control.sublime-package或Package Control.py在劫持通道,需手动清空Installed Packages/目录下所有含 “Package Control” 字样的文件
Install Package 卡在 “Fetching…”?网络问题没得绕
Package Control 默认走 HTTPS 请求 https://packagecontrol.io,不支持配置代理、不读取系统环境变量、也没有镜像源开关。国内直连基本不可靠,尤其在公司/校园网环境下。
- 换手机热点重试是最快速验证方式;若通了,说明是本地网络策略拦截
- 检查
Preferences → Settings用户配置中是否误写了"http_proxy": ""或"https_proxy": "null"—— 空字符串或非法值会导致底层 urllib 异常静默 - ST4 用户可在控制台执行:
urllib.request.urlopen('https://packagecontrol.io/').getcode(),返回200才算真正通路 - 无法科学上网时,唯一可行路径是手动下载插件 ZIP 包,解压后整体拖入
Packages/目录(注意:不是Installed Packages/,且不能嵌套子文件夹)
插件装完不生效?语法作用域和路径放错是主因
插件不是复制进去就自动工作。比如 Vue Syntax Highlight 只在 .vue 文件或作用域为 text.html.vue 时激活;纯 .html 文件不会触发。
- 右下角状态栏看当前语法标识,按
Ctrl+Shift+P输入Set Syntax: Vue看是否立刻高亮,可快速验证插件是否加载成功 -
Emmet.sublime-package必须扔进Installed Packages/;而解压后的Emmet/文件夹必须整体拖进Packages/(路径错一级,插件就彻底失联) - 检查
Preferences → Settings中"ignored_packages"数组,确认没把刚装的插件名写进去(如"Emmet"或"ConvertToUTF8") -
ConvertToUTF8只解决“打开乱码”,不改变保存编码;想存为 UTF-8,仍需手动选File → Save with Encoding → UTF-8
最常被忽略的一点:插件行为高度依赖语法作用域与配置加载顺序,而不是“装了=能用”。哪怕 Package Control 通了、插件也出现在 List Packages 里,只要当前文件没匹配到对应 scope,它就完全不工作——这点没法靠重启解决,只能查作用域、调语法、看控制台报错。

















