插件是否支持旧版Sublime Text需查其package-control.json中"sublime_text"字段，如">=4107"则ST3不兼容；手动安装旧版须克隆指定tag或commit，严格匹配文件夹名与结构，并彻底退出Sublime后重启验证加载。
确认插件是否支持旧版 Sublime Text
很多插件在 ST4 上能用，但在 ST3 或更早版本里会直接报 ImportError 或静默失败。尤其注意 Python API 差异：ST3 默认用 Python 3.3，ST4 升级到 Python 3.8+，sublime_plugin.EventListener 等类行为有变化；部分插件依赖 sublime_lib 或 mdpopups，这些库本身也有版本约束。
查兼容性最直接的方式是看插件 GitHub 的 README.md 或 package-control.json 里声明的 "sublime_text" 字段，例如："sublime_text": ">=3126" 表示最低需 ST3 Build 3126；若写 "sublime_text": ">=4107"，那 ST3 就完全不兼容。
- 打开插件仓库 → 点击
package-control.json文件 → 查sublime_text值 - 不确定时，在 ST3 控制台运行
sublime.version()，返回值如3211就是 ST3 - 别信“下载 ZIP 就能用”——GitHub 主分支往往是最新版，可能已删掉 ST3 兼容代码
下载指定 commit 或 tag 的源码
Package Control 不提供历史版本选择，手动安装旧版唯一可靠方式是 Git 克隆特定提交点。直接下载主分支 ZIP 很容易踩坑：比如 Emmet 在 v2.5.0 后移除了 ST3 支持，但主分支默认就是 v3.x。
操作前先关掉 Sublime Text，避免文件被占用：
- 进
Packages/目录（用Preferences → Browse Packages…打开） - 终端执行：
git clone --depth 1 -b v2.4.1 https://github.com/sergeche/emmet-sublime.git Emmet - 若仓库没打 tag，用 commit hash：
git clone --depth 1 --branch 4a9f3c2 https://github.com/facelessuser/SublimeLinter.git SublimeLinter - 克隆完删掉
.git文件夹（Sublime 不需要它，还可能引发加载冲突）
文件夹命名与结构必须严格匹配
ST3 对插件名大小写和路径极其敏感。比如 BracketHighlighter 放成 brackethighlighter 或 BracketHighlighter-master，控制台就会打印 reloading plugin BracketHighlighter failed 并跳过加载。
常见错误来源：
- GitHub 下载 ZIP 解压后多出一层
plugin-name-main或plugin-name-v2.0，必须把这层删掉，只留含.py文件的根文件夹 - 文件夹名含空格（如
Git Gutter）或点号（如SideBarEnhancements.v2），ST3 会直接忽略 - 插件依赖其他包（如
SublimeLinter依赖SublimeLinter-tool），只装主包会导致ImportError: No module named 'sublimelinter'
重启后验证是否真加载成功
ST3 不会在运行中扫描新目录，只在启动时加载 Packages/ 下的文件夹。简单按 Ctrl+R 或关窗口再开，后台进程可能还在跑，插件根本没重载。
务必彻底退出：
- Windows：任务管理器结束所有
subl.exe进程 - macOS：Dock 右键 → Quit（不是关闭窗口）
- Linux：命令行执行
pkill -f sublime
启动后立刻打开控制台（Ctrl+`），观察是否有 reloading plugin XXX 行。没有？说明路径、命名或依赖任一环节出错。有报错？重点看第一行错误类型：ImportError 指缺依赖，SyntaxError 指 Python 版本不兼容，AttributeError 往往是 API 调用变更。
真正麻烦的是那种“没报错也没反应”的情况——大概率是插件被 ignored_packages 列表屏蔽了，或者语法作用域不匹配（比如 Vue 插件只在 .vue 文件生效，你在 .html 里试就看不到效果）。
