离线安装sublime text插件本质是确保文件被正确扫描：package control必须放入installed packages目录且命名严格为package control.sublime-package，github插件需重命名后放入packages根目录，路径、大小写、ignored_packages配置及彻底重启四者缺一不可。
离线安装 Sublime Text 插件，本质不是“装”，而是让 Sublime Text 在启动时能扫描到你放好的文件——路径错、命名错、没重启，它就当不存在。
Package Control 必须扔进 Installed Packages 目录
别被控制台里那句 Package Control installed 欺骗。ST4 上旧脚本会静默失败，真正生效的只有 Package Control.sublime-package 文件被正确放进 Installed Packages/ 目录。
- 先确认版本：
sublime.version()返回值必须是4xxx - 关闭 Sublime Text，清空
Installed Packages/下所有含Package Control字样的文件（包括残留的.sublime-package和文件夹） - 从可信镜像下载完整包（如
https://packagecontrol.cn/Package%20Control.sublime-package），文件大小应在180–220 KB；小于100 KB就是损坏，丢弃重试 - 把下载好的
Package Control.sublime-package直接拖入Installed Packages/根目录——不解压、不改名、不嵌套子文件夹 - 重启后按
Ctrl+Shift+P输入Package Control: List Packages，能列出插件才算真正加载成功
GitHub 插件要重命名后扔进 Packages 根目录
从 GitHub 点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 GitGutter-dev/ 这类带后缀的文件夹——Sublime 不认这层包装壳，必须手动剥离。
- 打开
Preferences → Browse Packages…，这就是你要操作的Packages/目录 - 把解压后的文件夹里真正含
__init__.py或主模块（如git_gutter.py）的子目录单独拎出来 - 重命名为规范名：
Emmet-master/→Emmet/，ConvertToUTF8-main/→ConvertToUTF8/，大小写必须与官方文档完全一致 - 整个重命名后的文件夹直接拖进
Packages/根目录（不是Packages/User/，也不是Installed Packages/） - 检查该文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
插件放对了却没反应？先查 ignored_packages
命令面板搜不到、快捷键无效、菜单不出现——90% 不是没装上，而是被 Sublime 主动跳过了。它不会报错，只会沉默忽略。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果刚放进去的插件名（比如
"Origami"）正好在这个列表里，它就被静默屏蔽 - 删掉对应项，或整行注释掉，保存后必须彻底退出再重开——只关窗口或
Cmd+Q可能残留后台进程 - 插件还常只在特定语法下触发：比如
VueSyntaxHighlight只响应.vue文件或text.html.vue作用域；开纯.html文件时右下角显示HTML，它就彻底沉默
路径和命名大小写敏感，Windows 上看着一样也不行
Sublime 内部按 Unix 规则比对路径和文件名，大小写错一个字母，它就当没这回事。
- 别信网上搜来的默认路径，不同系统、便携版、Snap 版甚至 ST3/ST4 的路径都不同
- 最可靠方式：菜单栏
Preferences → Browse Packages…打开的路径就是Packages/；它的上一级目录里的Installed Packages/才是另一个位置 - 不确定？按
Ctrl+`调出控制台，输入import sublime; sublime.packages_path()和sublime.installed_packages_path()，回车直接看真实路径 - 文件夹名必须和插件官方名完全一致：
PyV8（首字母大写），不能是pyv8或pyv8-master；EmacsProMode不能写成emacspromode
最容易被忽略的是：Sublime 不会提示“放错位置”，它只是沉默跳过；ignored_packages 列表也从不报错，只让插件彻底消失；后台进程残留导致新配置不加载——这些点卡住，比网络问题更难排查。
