离线安装Sublime插件核心是文件放对位置、命名准确、不错误解压：Package Control须将.sublime-package文件放入Installed Packages目录；GitHub下载的ZIP插件需重命名为规范名（如Emmet-master→Emmet）后整体拖入Packages目录；路径、大小写、ignored_packages及语法作用域均需严格匹配。
离线安装 Sublime Text 插件，核心就一条：文件放对位置、名字写对、别解压错类型——其余全是干扰项。装不上不是 Sublime 有问题，是路径或命名没对上。
Package Control 离线安装必须用 .sublime-package 文件丢进 Installed Packages
ST4 尤其严格：旧脚本或手动执行控制台命令会静默失败，必须走文件直投。确认版本是 sublime.version() 返回 4xxx 后，清空 Installed Packages/ 下所有含 Package Control 字样的文件，再放入官方镜像下载的 Package Control.sublime-package（大小应在 180–220 KB）。路径必须精准：
- Windows：
%APPDATA%\Sublime Text 4\Installed Packages\ - macOS：
~/Library/Application Support/Sublime Text 4/Installed Packages/ - Linux：
~/.config/sublime-text-4/Installed Packages/
重启后按 Ctrl+Shift+P 搜 Package Control: List Packages，能列出已装插件才算真正加载成功。
GitHub 下载的 ZIP 插件必须重命名后整个扔进 Packages 目录
从 GitHub 点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ 这类带后缀的文件夹——Sublime 不认。必须手动重命名为插件官方名，比如：
-
Emmet-master/→Emmet/ -
ConvertToUTF8-main/→ConvertToUTF8/ -
Origami-dev/→Origami/
大小写敏感，不能多空格、不能加下划线，改完直接拖进 Packages/ 根目录（不是子文件夹），不是 Installed Packages/。打开 Preferences → Browse Packages… 就是这个目录。
插件装了但命令不出现？先查 ignored_packages 和语法作用域
常见假性“未安装”：插件文件在位、重启也做了，但命令面板搜不到、快捷键无效。大概率是以下两个地方卡住了：
- 用户设置里写了
"ignored_packages": ["Emmet"]，刚放进去的插件名正好在列表中，Sublime 会彻底跳过加载 - 插件只在特定语法下激活，比如
Vue Syntax Highlight只响应.vue文件或作用域text.html.vue，打开.html文件时右下角显示HTML，它就完全沉默
按 Ctrl+Shift+P 输入 Set Syntax: 手动切换语法，再试命令；或打开 Preferences → Settings，检查右侧用户配置中 ignored_packages 是否包含你刚装的插件名。
PyV8 类二进制依赖插件需补全整个 PyV8 文件夹结构
Emmet、CSScomb 等老插件报 ImportError: No module named 'PyV8'，不是网络问题，是 ST3 兼容版缺本地二进制模块。必须手动补：
- 去 Gitee 镜像站下载对应系统的包，例如
pyv8-win64-p3.zip - 解压后把全部内容（含
__init__.py和pyv8.pyd或pyv8.so）放进Packages/PyV8/目录 - 文件夹名必须是
PyV8（首字母大写，不能小写，不能叫pyv8）
重启后打开控制台（Ctrl+`）观察有无新报错——这才是插件是否真正加载的信号，比菜单有没有多一项更可靠。
最容易被忽略的是：Sublime 从不提示“路径错误”，它只是沉默跳过；ignored_packages 列表也从不报错，只让插件彻底消失。验证是否生效，永远以控制台日志、命令面板可搜到、快捷键触发为第一标准，而不是“文件看起来放对了”。
