package control需用180–220 kb的.sublime-package文件直投installed packages目录,清空旧残留后重启,再通过命令面板验证;github插件须重命名去后缀并放packages根目录;路径大小写敏感且需检查ignored_packages和语法作用域。

Package Control必须用.sublime-package文件直投Installed Packages
ST4环境下,控制台显示“Package Control installed”不等于它真能用——旧版安装脚本会静默失败。必须确认版本是sublime.version()返回的4xxx后,彻底清空Installed Packages/目录下所有含“Package Control”字样的文件(包括残留的Package Control.sublime-package和可能存在的文件夹),再放入官方镜像下载的完整包。
文件大小必须在180–220 KB之间;小于100 KB说明下载损坏,丢弃重试。拖入Installed Packages/根目录时:不解压、不改名、不嵌套子文件夹。重启后按Ctrl+Shift+P输入Package Control: List Packages,能列出插件才算加载成功。
GitHub下载的ZIP插件要重命名后整体扔进Packages根目录
从GitHub点Download ZIP得到的压缩包,解压后默认是Emmet-master/或Origami-dev/这类带后缀的文件夹——Sublime不识别这层包装壳。必须手动进入该文件夹,把真正含__init__.py或主模块(如git_gutter.py)的子目录单独拎出,重命名为规范名:
-
Emmet-master/→Emmet/ -
ConvertToUTF8-main/→ConvertToUTF8/ -
VueSyntaxHighlight-dev/→VueSyntaxHighlight/
大小写必须与插件官方文档完全一致,不能多空格、不能加下划线、不能带-main或-dev后缀。整个重命名后的文件夹直接拖进Packages/根目录(不是Installed Packages/,也不是Packages/User/等子目录)。
插件放对了但命令搜不到?先查ignored_packages和语法作用域
命令面板搜不到、快捷键无效、菜单不出现——大概率不是没装上,而是被Sublime主动跳过。打开Preferences → Settings,检查右侧用户配置中是否有"ignored_packages"字段;如果刚放进去的插件名(比如"Emmet")正好在里面,它就被静默屏蔽。
插件还常只在特定语法下触发:比如VueSyntaxHighlight只响应.vue文件或text.html.vue作用域,开纯.html文件时右下角显示HTML,它就彻底沉默。可按Ctrl+Shift+P输入Set Syntax:手动切换语法再试命令;或临时注释掉ignored_packages项验证。
路径和命名必须严格匹配,Windows上看着一样也不行
别信网上搜来的默认路径,不同系统、便携版、Snap版甚至ST3/ST4的路径都不同。最可靠方式是菜单栏Preferences → Browse Packages…,点一下就打开真实Packages/目录;它的上一级里的Installed Packages/才是另一个位置。不确定?按Ctrl+`调出控制台,输入import sublime; sublime.packages_path()和sublime.installed_packages_path(),回车直接看路径。
ST4内部按Unix规则比对路径和命名,大小写敏感——Emmet和emmet是两个东西;Emmet-master和Emmet也互不识别。文件夹里至少得有一个.py文件,且其中定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类,否则Sublime根本不会加载。











