package control必须用.sublime-package文件直投installed packages目录,90%装不上是因误用控制台命令或放错位置;st4只认预编译的package control.sublime-package文件,且必须置于installed packages/目录下,版本需为4xxx,路径、文件名、重启均须精准匹配。

Package Control必须用.sublime-package文件直投Installed Packages目录
离线装不上Package Control,90%是因为误用了控制台命令或放错了位置。ST4根本不认旧版脚本,也不走网络校验——它只认一个预编译好的Package Control.sublime-package文件,且必须放在Installed Packages/里。
先确认版本:sublime.version()返回值要是4xxx。如果不是,别往下试,版本不匹配会导致静默失败。
- 关闭所有Sublime Text进程(Windows任务管理器杀光
subl.exe,macOS右键Dock→Quit,Linux执行pkill -f "subl") - 进入
Installed Packages/目录:菜单Preferences → Browse Packages…打开后,往上退一级,找Installed Packages文件夹 - 删掉里面所有含
Package Control字样的文件(包括Package Control.sublime-package和残留的临时文件) - 从国内镜像下载完整包:https://www.php.cn/link/becebedf1c232fd3fcd44dcd8c0ef821,文件大小必须是180–220 KB;小于100 KB说明下载不全,直接丢弃
- 把下载好的
Package Control.sublime-package文件直接拖进Installed Packages/,不解压、不改名、不嵌套子目录
重启后验证是否真正加载成功
只打开编辑器窗口不算重启,后台进程残留会让旧状态继续干扰。关完必须确认进程已退出,再重开。
验证三件事缺一不可:
-
Preferences菜单下出现Package Control和Package Settings两项 - 按
Ctrl+Shift+P调出命令面板,输入Install Package能匹配到选项 - 控制台(
Ctrl+`)执行sublime.installed_packages_path(),返回路径必须和你刚才拖入文件的路径一致
如果其中任一条件不满足,说明没装上——不是网络问题,是路径或文件本身有问题。
GitHub插件不能直接扔ZIP,必须重命名后放Packages根目录
从GitHub点Download ZIP得来的压缩包,解压后默认是Emmet-master/这类带-master后缀的文件夹。Sublime不会识别这种结构,它只认干净的插件名。
- 打开
Preferences → Browse Packages…,这就是你要操作的Packages/目录 - 把解压后的文件夹重命名为官方名:
Emmet-master/→Emmet/,Origami-dev/→Origami/,大小写必须完全一致 - 整个重命名后的文件夹拖进
Packages/根目录,不能放进User/或任何子文件夹 - 检查该文件夹内至少有一个
.py文件,且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
别信“拖进去了就完事”。ST4对命名和层级极其敏感,错一个字符或少一层目录,它就当不存在。
插件命令搜不到?先查ignored_packages和语法作用域
文件在位、重启也做了,但Ctrl+Shift+P搜不到命令、快捷键没反应——大概率不是没装上,而是被Sublime主动跳过了。
- 打开
Preferences → Settings,看右侧用户配置里有没有"ignored_packages"字段;如果刚装的插件名(比如"Emmet")正好在里面,它就被彻底禁用 - 插件常只在特定语法下生效:比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域,开纯.html文件时右下角显示HTML,它就完全沉默 - 临时验证:按
Ctrl+Shift+P输入Set Syntax:手动切换语法,或注释掉ignored_packages整行再重启
最易忽略的是大小写和路径层级:Windows文件系统不区分大小写,但ST4内部按Unix规则比对;packages/Emmet/和packages/emmet/在它眼里是两个东西。











