插件是否支持旧版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 仓库 → 找 package-control.json 文件 → 看 "sublime_text" 字段：
-
"sublime_text": ">=3126"：ST3 Build 3126 及以上可用 -
"sublime_text": ">=4107"：ST4 起步，ST3 完全不认 - 没这个字段？默认按最新版写，大概率只适配 ST4
不确定时，在 ST3 控制台运行 sublime.version()，返回值如 3211 就是 ST3；ST4 返回值通常是 4xxx。
手动安装旧版插件的唯一可靠路径
Package Control 不提供历史版本选择，下载 ZIP 或拖文件进 Packages/ 极易出错——GitHub 主分支往往是最新版，可能已删掉 ST3 兼容代码。真正可控的做法只有 Git 克隆指定 tag 或 commit：
- 先彻底退出 Sublime Text（Windows 用任务管理器杀掉所有
sublime_text.exe，macOS 用「活动监视器」强退） - Preferences → Browse Packages… 打开目录，终端
cd进去 - 执行克隆命令，注意两点：文件夹名必须与插件名一致（大小写敏感），且 不能带
.git文件夹：git clone --branch v2.4.1 --depth 1 https://github.com/sergeche/emmet-sublime.git Emmetgit clone --branch 4a9f3c2 --depth 1 https://github.com/facelessuser/SublimeLinter.git SublimeLinter - 克隆完立刻删掉生成的
.git文件夹（Sublime 加载时会冲突）
重启后看控制台输出：reloading plugin Emmet.xxx 中的路径是否指向你刚放进去的文件夹——这是唯一验证成功的方式。
防止 Package Control 自动覆盖旧版
不加防护，下次启动或后台检查时，Package Control 可能悄悄把你手动装的旧版替换成最新版。必须锁死：
- Preferences → Package Settings → Package Control → Settings – User
- 在用户设置里加一行：
"auto_upgrade_ignore": ["Emmet", "SublimeLinter"] - 插件名要严格匹配：不是仓库名（
emmet-sublime），也不是 ZIP 解压后的文件夹名（Emmet-Sublime），而是插件实际注册名，通常就是你克隆时用的文件夹名 - 保存后必须重启 Sublime，否则配置不生效
如果插件名含空格或特殊字符（如 Emacs Pro Essentials），查 packagecontrol.io 页面 URL 或插件仓库里的 package-metadata.json，取其中 "name" 字段值。
手动解压 ZIP 包时最容易踩的坑
没 Git 环境？只能下 ZIP，那得手动清理多层嵌套：
- GitHub 下载的
Origami-main.zip解压后是Sublime-Origami-main/Origami/，你只需要里面的Origami/文件夹（含__init__.py） - 把这层
Origami/直接提出来，放进Packages/，删掉外面所有中间文件夹 - 文件夹名必须全小写或首字母大写，和插件官方命名一致（比如
SideBarEnhancements，不是sidebarenhancements） - 别解压进
Installed Packages/—— 那里只放.sublime-package，放源码会完全忽略
ST3 和 ST4 的 Packages/ 路径不同，别混用。Windows 是 %APPDATA%\Sublime Text 3\Packages\ 或 %APPDATA%\Sublime Text 4\Packages\；macOS 是 ~/Library/Application Support/Sublime Text 3/Packages/ 或 ~/Library/Application Support/Sublime Text 4/Packages/。路径错一个字，插件就永远不会加载。
