手动安装sublime插件失败90%因目录放错：.sublime-package文件必须放入installed packages/目录，不解压、不改名；github下载的zip解压后文件夹须整体移入packages/根目录并规范重命名（如删-master、首字母大写），且需彻底退出sublime后重启。
手动安装 Sublime 插件失败，90% 是因为文件放错了目录——Packages/ 和 Installed Packages/ 完全不互通，混放等于白装。
插件文件该扔进哪个目录？
取决于你手头的是什么格式：
-
.sublime-package文件（如Emmet.sublime-package）→ 必须直接拖进Installed Packages/目录，不解压、不改名、不嵌套子文件夹 - 从 GitHub 下载的 ZIP 解压后得到的文件夹（如
GitGutter-master/）→ 必须整体放进Packages/根目录，且要先删掉-master或-main这层冗余层级
别猜路径。打开 Sublime → Preferences → Browse Packages…，弹出的窗口地址就是 Packages/；它的上一级目录里那个叫 Installed Packages/ 的文件夹，才是另一个位置。不确定？按 Ctrl+` 调出控制台，输入：import sublime; sublime.packages_path() 和 sublime.installed_packages_path()，回车看真实路径。
GitHub ZIP 解压后怎么重命名才有效？
GitHub 自动生成的 ZIP 解压后，常多出一层包装目录（如 SideBarEnhancements-main/），Sublime 不会识别它里面的 .py 文件。必须手动“提一层”：
- 进到
SideBarEnhancements-main/内部，找到含__init__.py或主模块（如side_bar.py）的子文件夹 - 把这个子文件夹单独剪出来，重命名为规范名称：首字母大写、无空格、无点号、无下划线、无中文、无
-master（例如SideBarEnhancements） - 整个文件夹拖进
Packages/顶层，不能放进User/、Default/或其他子目录 - 确认该文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
重启不彻底，插件永远不加载
只关窗口或按 Ctrl+R 刷新，Sublime 后台进程仍在运行，旧模块缓存未清，新插件根本不会被扫描：
- macOS：右键 Dock 图标 → Quit（不是关闭窗口），再打开「活动监视器」确认没有
subl进程残留 - Windows：打开任务管理器 → 结束所有
subl.exe进程（注意区分 ST3/ST4 实例） - Linux：终端执行
pkill -f "subl"，或先ps aux | grep subl找 PID 再kill -9
重启后立刻按 Ctrl+Shift+P，输入插件名看命令是否出现；没反应就打开控制台，盯住有没有 ImportError 或 reloading plugin XXX failed。
插件“装上了却找不到”，大概率是被 ignored
Sublime 不会报错，它只是沉默地跳过。常见原因有两个：
-
ignored_packages列表里包含了你刚装的插件名：打开 Preferences → Settings，检查右侧用户配置中是否有"ignored_packages"字段，比如["SideBarEnhancements"]，有就删掉整行，保存后必须重启 - 插件只在特定语法作用域触发：比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域，打开纯.html文件时完全没反应
最容易被忽略的是：Sublime 对路径层级和命名大小写极度敏感，packages/origami/ 和 packages/Origami/ 是两个不同东西；sublime.version() 返回 4xxx 就说明是 ST4，对校验更严格，旧版 Package Control.sublime-package 文件可能根本加载不了。
