package control必须用官方.sublime-package文件直投installed packages目录；st4下控制台提示“installed”≠成功，唯一可靠方式是清空旧残留、下载180–220kb的package control.sublime-package（空格编码为%20）、拖入installed packages/根目录、不解压不改名，重启后通过ctrl+shift+p执行list packages验证是否真正加载。
Package Control必须用.sublime-package文件直投Installed Packages
ST4环境下，控制台里出现“Package Control installed”提示≠真装上了——旧脚本会静默失败，根本不会加载命令。唯一可靠路径就是把官方发布的Package Control.sublime-package文件直接丢进Installed Packages/目录。
- 先按
Ctrl+`打开控制台，运行sublime.version()确认返回值是4xxx - 关闭Sublime Text，清空
Installed Packages/下所有含Package Control字样的文件（包括残留的.sublime-package和文件夹） - 从国内镜像下载完整包：https://www.php.cn/link/e24d10bcd13335d6929198e462e39f38（注意URL中空格是%20）
- 检查文件大小：必须在
180–220 KB之间；小于100 KB说明下载不全，丢弃重试 - 拖入
Installed Packages/根目录，不解压、不改名、不嵌套子文件夹
重启后验证是否真正加载成功
重启不是走个过场——没验证就等于没装。ST4对加载失败完全沉默，不报错、不提示，只让你搜不到命令。
- 按
Ctrl+Shift+P输入Package Control: List Packages，能列出插件才算加载成功 - 菜单栏
Preferences下应出现Package Control和Package Settings两项 - 控制台执行
sublime.installed_packages_path()，返回路径必须与你放文件的路径一致 - 如果仍搜不到
Install Package，说明Package Control.sublime-package没被识别——大概率是路径错、版本不匹配或文件损坏
GitHub插件ZIP包解压后必须重命名再放Packages根目录
GitHub点Download ZIP得到的压缩包，解压后默认是Emmet-master/或Origami-dev/这类带后缀的文件夹——Sublime完全不认这层包装壳。
- 打开
Preferences → Browse Packages…，这就是你要操作的Packages/目录 - 把解压后的文件夹里含
__init__.py或主模块（如git_gutter.py）的子目录单独拎出来 - 重命名为规范名：
Emmet-master/→Emmet/，ConvertToUTF8-main/→ConvertToUTF8/，大小写必须严格匹配官方文档 - 整个重命名后的文件夹直接拖进
Packages/根目录，不能放进User/、Default/或其他子文件夹 - 文件夹内至少得有一个
.py文件，且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
插件“装上了却没反应”的真实原因往往是ignored_packages或语法作用域
文件在位、重启也做了，但命令面板搜不到、快捷键无效——这不是安装失败，而是Sublime主动跳过了它。
- 打开
Preferences → Settings，检查右侧用户配置中是否有"ignored_packages"字段；如果刚装的插件名（比如"Emmet"）正好在里面，它就被彻底禁用 - 插件常只在特定语法下触发：比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域，开纯.html文件时右下角显示HTML，它就完全沉默 - 临时验证方法：按
Ctrl+Shift+P输入Set Syntax:手动切换语法，再试命令；或注释掉ignored_packages整行，保存后必须重启才生效 - 最易忽略的是路径和命名的大小写敏感性——
Emmet和emmet在Sublime眼里是两个东西，Windows上也区分大小写
