package control 能用插件才能装;需先验证通路是否打通,即 package control: list packages 返回空列表且 install package 触发加载,st4 用户须确认安装脚本哈希值为 6f4c264a 开头并删除残留文件,再执行 urlopen 测试连通性。

Package Control 能用,插件才真正能装;菜单里有“Install Package”不等于它能跑起来——这是最常被忽略的前提。
Package Control 安装后没反应?先验证通路是否打通
按 Ctrl+Shift+P 输入 Package Control: Install Package 后无任何加载提示、控制台静默、左下角不显示 Fetching list of available packages,基本说明通道未通。这不是网络慢的问题,而是根本没触发请求。
- 必须同时满足两个条件才算通:
Package Control: List Packages返回空列表(不是报错),且Package Control: Install Package触发加载动作 - ST4 用户若用了 ST3 的旧安装脚本(哈希值非
6f4c264a开头),控制台可能显示Success!,但后续所有命令都失效 - 残留文件会劫持命令:检查
Packages/和Installed Packages/目录下是否有Package Control.sublime-package或Package Control.py,有就删掉再重装 - ST4 可在控制台执行:
urllib.request.urlopen('https://packagecontrol.io/').getcode(),返回200才算真正连通
Install Package 卡在 “Fetching…” 怎么办
首次加载插件列表正常需 5–10 秒,超 30 秒没进展,就是卡在网络或配置上。公司/校园网屏蔽 packagecontrol.io 是高频原因,换手机热点通常 5 秒内恢复。
- 检查用户设置
Preferences → Settings右侧 JSON 中是否误配了代理:"http_proxy"或"https_proxy"值为空字符串、格式非法(如缺端口)、或指向已失效地址 - 代理配置错误比没配更危险——它会让请求卡死在 TLS 握手阶段,控制台只打印
reloading plugin就停住 - 已安装但被忽略?确认
"ignored_packages"数组里没把目标插件名写进去,比如"Emmet"或"Vue Syntax Highlight"
插件装完不生效?别急着重装,先查三件事
插件不是放进目录就自动工作,它依赖语法作用域、路径位置和配置落地位置。右下角状态栏当前语法显示什么,往往就是问题所在。
- 看右下角状态栏:比如
Vue Syntax Highlight只在.vue文件或作用域为text.html.vue时生效;纯.html文件不会触发 - 手动切换语法验证:
Ctrl+Shift+P输入Set Syntax: Vue,看是否立刻高亮——如果可以,说明插件本身没问题,只是语法没匹配上 - 路径必须严格对应:
Emmet.sublime-package必须扔进Installed Packages/;而解压后的Emmet/文件夹必须整体拖进Packages/(不能嵌套进子目录) - 配置必须写在
Packages/User/下同名.sublime-settings文件中,改插件自带的默认配置(时间戳是 2026 年)无效
EditorConfig、SublimeLinter 这类框架型插件要额外注意
它们本身不提供功能,只提供接入能力。装完只是第一步,后续必须单独安装对应语言的 linter 或配置文件,否则界面上看不到任何标记。
-
SublimeLinter装完后,还需装SublimeLinter-flake8(Python)、SublimeLinter-eslint(JS)等具体检查器,且系统 PATH 中必须能调用对应 CLI 工具 -
EditorConfig需项目根目录存在.editorconfig文件,且文件扩展名要匹配root = true下的[*]或[*.py]等规则 - 这类插件的配置项多在
Preferences → Package Settings下,而非全局Settings,容易漏改
真正难的不是“怎么点”,而是判断哪一层断了:是网络没通、路径放错、语法不匹配,还是框架没接上具体工具。每层都有明确验证方式,逐层排除比反复重装快得多。











