离线安装sublime插件失败主因是路径错误、命名不符或被忽略；需确认st4版本、清空installed packages后放入正确大小的package control文件，github插件须重命名并放至packages根目录，检查ignored_packages及语法作用域。
离线安装 Sublime 插件，本质不是“装不上”，而是文件没放对位置、名字写错、或被 Sublime 主动跳过了——90% 的失败都卡在这三步。
Package Control 必须用 .sublime-package 文件直投 Installed Packages
ST4 启动后按 Ctrl+Shift+P 搜不到 Package Control: Install Package？说明它根本没加载。控制台显示 “Package Control installed” 是旧脚本的静默假象，不是真能用。
- 先运行
sublime.version()确认返回值是4xxx - 彻底关闭 Sublime Text，进
Installed Packages/目录，删掉所有含Package Control字样的文件（包括Package Control.sublime-package和残留文件夹） - 从可信镜像下载完整包（大小必须在
180–220 KB；小于100 KB就是损坏，丢弃重试） - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/根目录——不解压、不改名、不嵌套子文件夹 - 重启后，按
Ctrl+Shift+P输入Package Control: List Packages，能列出插件才算真正生效
GitHub 下载的 ZIP 插件要重命名后扔进 Packages 根目录
从 GitHub 点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 VueSyntaxHighlight-dev/ 这类带后缀的文件夹——Sublime 不识别这层包装壳，会直接忽略。
- 打开
Preferences → Browse Packages…，这就是你要塞插件的Packages/目录 - 进解压后的文件夹，把真正含
__init__.py或主模块（如git_gutter.py）的子目录单独拎出 - 重命名为规范名：
Emmet-master/→Emmet/，ConvertToUTF8-main/→ConvertToUTF8/，大小写必须和官方文档完全一致 - 整个重命名后的文件夹直接拖进
Packages/根目录（不是Installed Packages/，也不是Packages/User/）
插件放对了但命令搜不到？先查 ignored_packages 和语法作用域
命令面板无响应、快捷键无效、菜单不出现，大概率不是没装上，而是被 Sublime 主动屏蔽或限制触发条件。
- 打开
Preferences → Settings，检查右侧用户配置中是否有"ignored_packages"字段；如果刚放进去的插件名（比如"Emmet"）正好在里面，它就被静默禁用 - 插件常只在特定语法下触发：比如
VueSyntaxHighlight只响应.vue文件或text.html.vue作用域；开纯.html文件时右下角显示HTML，它就彻底沉默 - 按
Ctrl+Shift+P输入Set Syntax:手动切换语法再试命令；或临时注释掉ignored_packages验证是否是该字段导致
路径和命名大小写敏感，Windows 上看着一样也不行
别信网上搜来的默认路径，不同系统、便携版、Snap 版甚至 ST3/ST4 的路径都不同。最可靠方式是用 Sublime 自己报出来的路径。
- 按
Ctrl+`调出控制台，输入import sublime; sublime.packages_path()和sublime.installed_packages_path()，回车直接看真实路径 - 文件夹名不能多空格、不能加下划线、不能带
-master或-dev后缀；EmacsProMode≠emacspromode≠EmacsProMode-master - 更新插件时，必须先删旧文件夹或旧
.sublime-package，再放新版本——Sublime 会缓存模块导入状态，旧代码可能还驻留在内存里
最容易被忽略的是：重启必须彻底——macOS 要用 Activity Monitor 杀掉所有 Sublime Text 进程，Windows 要在任务管理器中结束全部相关进程；只关窗口或 Cmd+Q 不等于退出后台。
