package control必须用官方.sublime-package文件直投installed packages目录，github插件须重命名后放入packages根目录；路径、大小写、ignored_packages及语法作用域均需严格匹配，否则静默失败。
Package Control必须用.sublime-package文件直投Installed Packages
ST4里靠控制台命令或旧脚本装Package Control基本失效，哪怕控制台显示“installed”，Ctrl+Shift+P搜不到Package Control: Install Package就等于没装上。
- 先确认版本：
sublime.version()返回值必须是4xxx - 完全退出Sublime，进
Installed Packages/目录，删掉所有含Package Control字样的文件（包括Package Control.sublime-package和残留文件夹） - 从可信镜像下载完整包（如
https://www.php.cn/link/7574933a1b39d861a171370e4582ec28），文件大小必须在180–220 KB；小于100 KB说明下载损坏，直接丢弃 - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/根目录——不解压、不改名、不嵌套子文件夹
重启后，Ctrl+Shift+P输入Package Control: List Packages能列出已装插件才算真正加载成功。
GitHub下载的ZIP插件必须重命名后扔进Packages根目录
点Download ZIP得到的压缩包解压后，顶层通常是Emmet-master/或GitGutter-main/这类带后缀的文件夹——Sublime根本不会扫描它里面的内容。
- 打开
Preferences → Browse Packages…，这就是你要操作的Packages/目录（不是Installed Packages/） - 进解压后的文件夹，找到含
__init__.py或主模块文件（如git_gutter.py）的子目录 - 把这个子目录剪切出来，重命名为插件官方名：
Emmet-master/→Emmet/，Origami-dev/→Origami/，ConvertToUTF8-main/→ConvertToUTF8/ - 名字必须大小写完全一致，不能多空格、不能加下划线、不能带
-master等后缀 - 整个重命名后的文件夹直接拖进
Packages/根目录，不能放进User/或Default/等子文件夹
插件“装了但不生效”大概率被ignored_packages屏蔽或语法作用域不匹配
文件在位、重启也做了，命令面板搜不到、快捷键无效——这不是安装失败，而是Sublime主动跳过了它。
- 打开
Preferences → Settings，检查右侧用户配置中是否有"ignored_packages"字段；如果刚放进去的"Emmet"或"GitGutter"正好在里面，它就被静默禁用 - 临时注释掉整行或删掉对应项，保存后必须完全退出Sublime（macOS用Dock右键Quit，Windows结束所有
subl.exe进程），再重启 - 很多插件只在特定语法下触发：比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域；开纯.html文件时右下角显示HTML，它就彻底沉默 - 按
Ctrl+Shift+P输入Set Syntax:手动切换语法，再试命令
路径和命名大小写敏感，Sublime从不报错只沉默跳过
你永远看不到“路径错误”或“名称不匹配”的提示——它只是安静地忽略你放进去的东西。动手前务必确认两件事：
- 用
Preferences → Browse Packages…打开目录，这是唯一可信的Packages/路径；不确定的话，在控制台运行print(sublime.packages_path())和print(sublime.installed_packages_path())验证 - ST4对校验更严格，旧版
Package Control.sublime-package可能根本加载不了；GitHub插件名大小写错一个字母（比如emmet小写），插件就永远不会被识别
最易忽略的是：路径层级、命名一致性、ignored_packages列表——三者任一出错，Sublime都保持沉默，而不是报错。
