sublime手动安装插件不生效，90%因路径错误：.sublime-package文件须放入installed packages/，解压后的插件文件夹须整体放入packages/根目录；放错目录sublime会静默跳过，且需检查ignored_packages是否屏蔽该插件并重启生效。
Sublime手动安装插件后插件不生效，90%是因为文件放错了目录——不是代码有问题，也不是网络没连上，而是Packages和Installed Packages这两个目录被混用了，Sublime会直接跳过错误位置的文件，连控制台都不报错。
确认当前真正生效的Packages目录在哪
别猜路径，也别复制网上搜来的默认路径。Windows/macOS/Linux/便携版/Snap版的路径都不同，ST3和ST4的目录名还不一样（比如ST4默认是sublime-text，不是sublime-text-4）。
最可靠的方法：菜单栏点击 Preferences → Browse Packages…，点一下就打开文件管理器，这个窗口里的位置就是唯一可信的加载目录。
如果打开的是空文件夹，说明你还没装过任何插件，但目录本身是有效的——直接往里放就行。
更进一步验证：按 Ctrl+` 调出控制台，输入 import sublime; sublime.packages_path()，回车后直接看到真实路径。
区分两种插件文件，对应两个不同目录
方法一：你下载的是带 .sublime-package 后缀的单个文件（例如 Emmet.sublime-package）→ 必须放进 Installed Packages/ 目录，不解压、不改名、不嵌套子目录。
方法二：你从 GitHub 下载的是 ZIP 压缩包（例如 Emmet-master.zip），解压后得到一个叫 Emmet-master 的文件夹 → 进入该文件夹，把里面真正含 __init__.py 或主模块文件（如 emmet.py）的子文件夹单独拎出来，重命名为规范名称（如 Emmet，首字母大写、无空格、无中文、无点号、无 -master 后缀），然后整个文件夹拖进 Packages/ 目录顶层。
【注意】 用 Preferences → Browse Packages… 打开的是 Packages/；它的上一级目录里才有 Installed Packages/。千万别把 .sublime-package 文件拖进 Packages/，也别把解压后的文件夹扔进 Installed Packages/——放错等于没装。
检查插件是否被 ignored_packages 静默屏蔽
第一步：打开 Preferences → Settings，看右侧用户配置中是否有 "ignored_packages" 字段。
第二步：如果刚放进去的插件名（比如 "GitGutter"）出现在这个列表里，它就会被 Sublime 主动忽略，命令面板搜不到、快捷键不触发、菜单不出现。
第三步：删掉对应项，或整行注释掉，保存后必须重启 Sublime 才生效。
离线更新插件时彻底清旧再放新
1. 先关闭 Sublime Text。
2. 进到 Packages/ 目录，删掉整个旧插件文件夹（如 ConvertToUTF8/），或删掉旧的 .sublime-package 文件（在 Installed Packages/ 目录下）。
3. 把新版本放进去，确保文件夹名 / 文件名完全一致（大小写敏感）。
4. 重启 Sublime，打开控制台（Ctrl+`）观察有无 ImportError 或 reloading plugin 日志，确认加载的是新版。
