旧版Sublime Text（ST3）装插件的关键是版本匹配、路径正确与Python API兼容：需查package-control.json中"sublime_text"字段确认支持版本，手动安装时严格遵循文件夹命名、路径规范，并配置auto_upgrade_ignore防止被自动覆盖，最后通过控制台报错、命令面板响应等逐项验证。
旧版 Sublime Text（ST3 或更早）装插件，核心不是“能不能装”，而是“装的版本对不对、路径认不认、Python API 兼容不兼容”。直接用 Package Control 搜、装，大概率失败或静默崩溃。
确认插件是否真支持你的 Sublime 版本
很多插件 GitHub 主页写的“支持 Sublime Text”其实是默认指 ST4，ST3 用户点进去才发现 README 里一行小字：“requires ST4+”。最靠谱的方式是查 package-control.json 文件里的 "sublime_text" 字段：
- 打开插件仓库 → 找到
package-control.json→ 看"sublime_text": ">=3126"这类声明；>=3126表示 ST3 Build 3126 起可用，>=4107就彻底跟 ST3 无缘 - 不确定时，在 ST3 控制台运行
sublime.version()，返回值如3211就是 ST3 Build 3211 - 别信“下载 ZIP 就能用”——主分支代码往往已删掉 ST3 兼容层，比如 Emmet v2.5.0+ 就不再支持 ST3
手动安装旧版插件的三步硬操作
Package Control 不提供历史版本选择，靠它装旧版等于碰运气。必须手动拉、手动放、手动锁：
- 先关掉 Sublime Text，包括后台进程（Windows 任务管理器杀
sublime_text.exe，macOS 活动监视器强制退出） - 进
Packages/目录（Preferences → Browse Packages…），终端执行：git clone --depth 1 -b v2.4.1 https://github.com/sergeche/emmet-sublime.git Emmet—— 注意文件夹名必须是Emmet，不能是emmet-sublime或Emmet-master - 克隆完删掉插件目录下的
.git文件夹，ST3 加载时会因权限或结构异常跳过整个插件
防止 Package Control 自动覆盖你刚装的旧版
哪怕你手动装好了 v2.4.1 的 Emmet，Package Control 下次启动仍可能把它换成最新版（v3.x），导致插件直接失效：
- 打开 Preferences → Package Settings → Package Control → Settings – User
- 加一行：
"auto_upgrade_ignore": ["Emmet"]—— 插件名必须和文件夹名完全一致，大小写敏感 - 保存后彻底重启 Sublime，控制台出现
reloading plugin Emmet.xxx才算真正加载成功
常见路径与命名坑点
ST3 对路径和命名极其苛刻，错一个字符就静默失败：
- 文件夹名含空格（如
Git Gutter）或点号（如SideBarEnhancements.v2），ST3 直接忽略加载 - GitHub ZIP 解压后多一层
Sublime-Origami-main/，必须把这层删掉，只留根目录下含__init__.py的Origami/文件夹 - Linux/macOS 下大小写敏感，
brackethighlighter和BracketHighlighter是两个不同插件，后者才对
旧版 Sublime 插件安装真正的难点不在操作步骤，而在验证：控制台有没有报 ImportError、命令面板能不能搜到对应命令、快捷键按了有没有反应——这些都得逐项手动测，不能只看文件放没放对。
