手动安装插件需三步：用Browse Packages…或控制台查准路径，解压ZIP时剔除-master层并重命名文件夹，重启后检查ignored_packages、语法作用域及控制台报错。
手动安装插件包，本质就是把代码放对位置 + 彻底重启 + 控制台验证，不是复制粘贴完就完事。
怎么找到真正的 Packages 目录？别猜路径，用菜单或控制台查
Windows/macOS/Linux/便携版/Snap 版的路径全不一样，ST3 和 ST4 的默认目录名也不同（比如 ST4 是 sublime-text，不是 sublime-text-4）。网上搜来的路径大概率错。
- 最稳方法：Sublime 里点 Preferences → Browse Packages…，弹出的文件夹就是
Packages/目录 - 它的上一级那个叫
Installed Packages/的文件夹，只收.sublime-package文件，不收文件夹 - 不确定？按
Ctrl+`打开控制台，输import sublime; sublime.packages_path()和sublime.installed_packages_path()，回车直接看真实路径
GitHub 下载的 ZIP 怎么解压才不白忙？必须砍掉 -master 层
点 “Download ZIP” 得到的压缩包，解压后通常多出一层 PluginName-master 或 PluginName-main —— 这层是 GitHub 自动生成的包装壳，Sublime 根本不认。
- 进到那层文件夹里，把真正含
__init__.py或主模块（如git_gutter.py）的子文件夹单独拎出来 - 重命名为干净名称：
GitGutter（首字母大写、无空格、无中文、无点号、无-master后缀） - 整个文件夹拖进
Packages/根目录，不能塞进Packages/User/或Packages/Default/ - 检查文件夹里至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
放对了还不生效？先查 ignored_packages 和语法作用域
插件在 Packages/ 里，命令面板搜不到、快捷键没反应，90% 是被 Sublime 主动忽略了。
- 打开 Preferences → Settings – User，看右侧有没有
"ignored_packages"字段；如果刚放进去的插件名（比如"Emmet"）也在这个列表里，它就被静默禁用了 - 有些插件只在特定语法下触发 —— 比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域；开个纯.html文件时它不会加载 - 重启后按
Ctrl+`看控制台，如果有reloading plugin XXX failed或ImportError，说明 Python 模块缺失或 API 不兼容（尤其 ST3/ST4 差异）
Package Control 本身没装好？手动装也得走对路
命令面板搜 Package Control: Install Package 没结果，说明 Package Control 根本没加载。控制台显示 Package Control installed 不等于真能用 —— ST4 上旧脚本会静默失败。
- 先运行
sublime.version()确认是4xxx版本 - 关掉 Sublime，进
Installed Packages/，删掉所有含Package Control字样的文件（包括Package Control.sublime-package） - 去官网下载最新版
Package Control.sublime-package（大小应在 180–220 KB；小于 100 KB 就是下载不完整） - 把下载好的文件直接拖进
Installed Packages/，不要解压、不要改名、不要放进子文件夹
最容易被忽略的其实是“重启不彻底”——Windows 任务栏右键退出、macOS 强制退出、Linux 杀掉所有 subl 进程，否则新插件根本不会扫描加载。
