插件失效主因是路径错误：.sublime-package文件须放入installed packages/，解压后的插件文件夹须整体放入packages/根目录并重命名规范；路径须通过preferences → browse packages…确认；放错则sublime静默跳过。
插件文件放错目录是失效主因
Sublime 不会扫描 Installed Packages/ 下的文件夹，也不会加载 Packages/ 里名字不规范或结构不对的插件。手动导入失败，90% 是因为路径错了——Packages/ 和 Installed Packages/ 完全不同，混放等于白忙。
必须先通过菜单打开真实路径：Preferences → Browse Packages…，弹出的窗口才是你要操作的 Packages/ 目录（Windows 是 %APPDATA%\Sublime Text\Packages\，macOS 是 ~/Library/Application Support/Sublime Text/Packages/，Linux 是 ~/.config/sublime-text/Packages/）。
-
.sublime-package文件（如PackageControl.sublime-package）只能放进Installed Packages/，不能解压、不能改名、不能嵌套 - 解压后的插件文件夹（含
.py文件）必须整体移入Packages/根目录，不能丢进子文件夹，也不能留着 GitHub 自带的plugin-name-master/外层包装 - 插件文件夹名必须和官方仓库名一致（大小写敏感），比如
Emmet，不是emmet-sublime或Emmet-master - 文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand等的类，否则控制台会报reloading plugin XXX failed
GitHub 下载 ZIP 后要“剥壳”再重命名
从 GitHub 点 Code → Download ZIP 得到的压缩包，解压后通常多出一层 plugin-name-main 或 plugin-name-master。这层是 GitHub 自动生成的，Sublime 加载时根本找不到入口模块。
正确做法是：解压后进入那层多余目录，把真正含 __init__.py 或 plugin_name.py 的子文件夹单独拎出来，重命名为干净名称（如 SideBarEnhancements），再拖进 Packages/ 根目录。
- 名字不能含空格、中文、点号（
.）、短横（-）以外的特殊字符，否则 Sublime 可能跳过加载 - 检查该文件夹是否直接包含
.py文件，而不是藏在更深的子目录里 - 重启前务必完全退出 Sublime（任务管理器里确认进程已结束），否则新增文件夹不会被扫描
依赖缺失导致插件静默失败
有些插件（如 GitGutter 或 BracketHighlighter）依赖其他库，比如 sublime_lib 或 mdpopups。只放主插件文件夹，控制台会报 ImportError: No module named 'some_missing_dep'，但界面毫无提示。
这类依赖本身也是独立插件，必须一并手动导入——它们同样要放进 Packages/ 根目录，且命名规范、结构完整。
- 去插件 GitHub 页面的
dependencies或requirements部分查清依赖项 - 每个依赖都要单独下载、剥壳、重命名、移入
Packages/ - 依赖插件的加载顺序无关紧要，Sublime 启动时统一扫描，但缺一个就整个主插件失效
- 如果控制台报
reloading plugin XXX failed且没提具体模块名，大概率是依赖缺失，而非主插件本身有问题
验证是否生效别只看菜单
重启后不要只盯着 Preferences → Package Settings 是否出现菜单项——有些插件根本不加菜单，而是靠快捷键或命令面板触发。最可靠的方式是打开命令面板 Ctrl+Shift+P，输入插件名关键词，看有没有对应命令出现。
如果命令面板搜不到，再打开控制台 Ctrl+`，看有没有 reloading plugin XXX 日志。没有这条日志，说明 Sublime 根本没识别到这个插件，问题一定出在路径、命名或结构上。
- 命令面板里出现命令 ≠ 插件功能正常，可能只是注册成功；真正执行时报错，得看控制台后续输出
- 部分插件（如
ANSYS Syntax Highlighting）只提供.sublime-syntax文件，这类必须放进Packages/User/才生效，放Packages/根目录无效 - 插件启用状态由
Packages/User/Package Control.sublime-settings中的installed_packages字段控制，手动导入不自动写入该字段，但不影响加载
