package control必须离线安装且仅识别.sublime-package文件：先确认st4版本、清空installed packages/中所有相关文件，下载完整包（180–220kb）放入该目录，完全退出后重启，再通过ctrl+shift+p执行list packages验证加载成功。
Package Control 必须离线装，且只认 .sublime-package 文件
ST4 环境下，控制台里看到 Package Control installed 不代表它真能用——旧版安装脚本在 ST4 上会静默失败。必须用官方发布的 Package Control.sublime-package 文件直投 Installed Packages/ 目录。
- 先运行
sublime.version()确认是 4xxx 版本 - 关闭 Sublime，清空
Installed Packages/下所有含Package Control字样的文件（包括残留的.sublime-package和可能存在的文件夹） - 从镜像站下载完整包（大小应在
180–220 KB；小于100 KB就是下载损坏） - 拖入
Installed Packages/根目录，不改名、不解压、不嵌套子目录
重启后按 Ctrl+Shift+P 搜 Package Control: List Packages，能列出插件才算加载成功。
GitHub 下载的 ZIP 插件必须重命名后放 Packages/ 根目录
点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ —— 这层后缀是 GitHub 自动生成的包装壳，Sublime 完全不识别。
- 进到该文件夹内，找到含
__init__.py或主模块（如emmet.py）的子目录 - 把整个子目录剪切出来，重命名为规范名：
Emmet-master/→Emmet/，Origami-dev/→Origami/ - 名字必须大小写严格匹配官方文档，不能带空格、下划线、点号或版本后缀
- 直接拖进
Packages/根目录（不是Installed Packages/，也不是子文件夹）
不确定路径？菜单 Preferences → Browse Packages… 打开的就是唯一可信的 Packages/ 目录；控制台输 print(sublime.packages_path()) 也能验证。
插件“装了但没反应”？先查 ignored_packages 和语法作用域
命令面板搜不到、快捷键无效、菜单不出现——90% 是被 Sublime 主动屏蔽，而不是没装上。
- 打开
Preferences → Settings，检查右侧用户配置中是否有"ignored_packages"字段；如果刚放进去的"GitGutter"正好在列表里，它就彻底静默 - 删掉对应项或整行注释，保存后必须完全退出 Sublime（macOS 用 Dock 右键 Quit，Windows 结束所有
subl.exe进程），再重启 - 有些插件只在特定语法下激活：比如
Vue Syntax Highlight只响应.vue文件或作用域text.html.vue；打开.html文件时右下角显示HTML，它就不工作 - 按
Ctrl+Shift+P输入Set Syntax:切换语法，再试命令
老插件报 PyV8 错误？不是网络问题，是依赖缺失
装 Emmet、CSScomb 等老插件时，控制台反复出现 ImportError: No module named 'PyV8'，这不是代理或证书问题，而是二进制依赖未就位。
- PyV8 官方源已归档，Package Control 拿不到地址，必须手动补全
- 去 Gitee 镜像站下载对应系统和 Python 版本的包（如
pyv8-win64-p3.zip） - 解压后，把所有内容（含
__init__.py和pyv8.pyd/pyv8.so）直接塞进Packages/PyV8/文件夹 - 注意：文件夹名必须是
PyV8（首字母大写），小写或拼错就加载失败
路径层级、命名一致性、ignored_packages、语法作用域——这四点任何一个出错，Sublime 都不会报错，只会沉默跳过。别靠猜测，用 Browse Packages… 和控制台日志定位真实位置。
