手动安装插件失败主因是文件路径错误、ignored_packages拦截或ST4中Package Control未加载；需按.sublime-package或文件夹类型分别放入Installed Packages/或Packages/根目录，检查ignored_packages配置，重装ST4专用Package Control，并注意作用域限制。
手动安装插件不难，难在文件放错目录、被 ignored_packages 拦截、或 ST4 上 Package Control 本身就没加载成功——这三类问题占失败案例的 90% 以上。
确认插件文件类型再决定扔哪：.sublime-package 还是文件夹？
Sublime Text 对两类安装包有硬性路径要求，混放等于白装：
-
.sublime-package文件（如Emmet.sublime-package）→ 必须直接拖入Installed Packages/目录，不能解压、不能改名、不能放进子文件夹 - 从 GitHub 下载的 ZIP（如
Emmet-master.zip）→ 解压后得到一个文件夹（比如叫Emmet）→ 整个文件夹复制进Packages/根目录，不能嵌套在子文件夹里，文件夹名必须和插件官方名完全一致（大小写敏感） - 不确定当前路径？打开控制台按
Ctrl+`，输入print(sublime.packages_path())和print(sublime.installed_packages_path())查真实路径
插件放对了却没反应？先查 ignored_packages 配置
命令面板搜不到、快捷键无效、菜单不出现——大概率不是插件坏了，而是被 Sublime 主动忽略了：
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果刚放进去的插件名（比如
"Emmet"或"ConvertToUTF8"）出现在这个列表里，它就被静默禁用了 - 临时删掉对应项，或整行用
//注释掉，保存后重启验证
ST4 上 Package Control 搜不到 Install Package？说明它根本没加载
别信控制台里那句 “Package Control installed” —— ST4 兼容旧脚本，会静默失败：
- 先运行
sublime.version()确认是4xxx版本 - 关闭 Sublime Text，进
Installed Packages/目录，删掉所有含Package Control字样的文件（包括Package Control.sublime-package） - 去 https://www.php.cn/link/becebedf1c232fd3fcd44dcd8c0ef821 下载 ST4 专用版（文件大小应在 180–220 KB；小于 100 KB 是下载不全）
- 把下载好的
Package Control.sublime-package直接拖入Installed Packages/，重启后按Ctrl+Shift+P搜Package Control: Install Package确认存在
离线更新插件时，覆盖 ≠ 更新，必须彻底删除旧版
Sublime 会缓存模块导入状态，旧代码可能还驻留在内存里：
- 关闭 Sublime Text
- 进
Packages/目录，删掉整个旧插件文件夹（如VueSyntaxHighlight），或进Installed Packages/删掉对应的.sublime-package文件 - 再把新版本放进去，确保文件夹名 / 文件名与旧版完全一致（大小写敏感）
- 重启后打开控制台观察日志：出现
reloading plugin xxx且无ImportError才算真正加载了新版
最容易被忽略的是：插件只在特定语法作用域生效。比如 Vue Syntax Highlight 只响应 .vue 文件或 text.html.vue 作用域，打开纯 .html 文件时它就“消失”了——这不是故障，是设计如此。
