Package Control离线安装必须用.sublime-package文件直投Installed Packages/
ST4环境下，控制台里出现“Package Control installed”不等于真装上了——旧脚本会静默失败，唯一可靠方式是手动把Package Control.sublime-package文件放进Installed Packages/目录。别解压、别改名、别嵌套子文件夹，否则Sublime直接无视。
先确认版本：打开控制台（Ctrl + `），运行sublime.version()，返回值必须是4xxx。如果不是，你可能在用ST3，路径和兼容性都不同，得另处理。
- 关闭所有Sublime进程（Windows右键任务栏选「退出」，macOS菜单栏选「Quit Sublime Text」）
- 进
Installed Packages/目录，删掉所有含Package Control字样的文件（包括残留的Package Control.sublime-package和可能存在的文件夹） - 从可信镜像下载完整包：https://www.php.cn/link/becebedf1c232fd3fcd44dcd8c0ef821（注意URL中空格是
%20） - 检查文件大小：必须在
180–220 KB之间；小于100 KB说明下载不全，丢弃重试 - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/根目录
路径错了就等于没装，必须用sublime.installed_packages_path()验证
别凭记忆或“看起来像”就放文件。Windows、macOS、Linux的Installed Packages/路径完全不同，且ST4和ST3还差一个数字。靠错路径装10次都不如查一次真实路径。
重启Sublime后，立刻打开控制台，执行：print(sublime.installed_packages_path())。它返回的才是Sublime真正读取.sublime-package的位置。
- Windows典型路径：
%APPDATA%\Sublime Text 4\Installed Packages\ - macOS典型路径：
~/Library/Application Support/Sublime Text 4/Installed Packages/ - Linux典型路径：
~/.config/sublime-text-4/Installed Packages/ - 如果返回路径和你放文件的位置不一致，说明你放错了地方，重来
装完仍找不到Install Package？验证加载成功的唯一方法
菜单里有Package Control项、控制台提示installed、甚至能进Package Settings——这些都不是真正加载成功的证据。唯一靠谱验证方式是命令面板能否执行Package Control: List Packages。
重启后按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages。如果命令可选且执行后返回一个列表（哪怕为空），说明Package Control已加载成功；如果根本搜不到这条命令，就是没装上，回前两步检查路径和文件完整性。
- 常见假信号：
ImportError: No module named 'package_control'，说明Python模块根本没导入，不是网络问题，是本体缺失 - 如果命令能搜到但执行报错
AttributeError: 'NoneType' object has no attribute 'get'，大概率是残留旧版干扰，再清一遍Installed Packages/ - 别信“重启一次就好”，必须完全退出进程再启动，后台常驻的Sublime会缓存旧状态
GitHub插件不能直接扔ZIP，必须重命名后放Packages/根目录
Package Control只是包管理器，它本身不负责插件加载。你离线装的其他插件（比如Emmet、Origami）必须走另一条路：解压后重命名，整体扔进Packages/目录，而不是Installed Packages/。
从GitHub点Download ZIP得到的压缩包，解压后默认是Emmet-master/或ConvertToUTF8-main/——这层后缀是GitHub自动生成的包装壳，Sublime根本不认。
- 打开
Preferences → Browse Packages…，这就是你要往里塞插件的Packages/目录 - 把解压后的文件夹重命名为官方名：
Emmet-master/→Emmet/，Origami-dev/→Origami/ - 名字必须大小写严格一致，不能多空格、不能加下划线、不能带
-master后缀 - 整个重命名后的文件夹直接拖进
Packages/根目录（不是子文件夹，也不是Installed Packages/）
路径、命名、目录层级这三处，错任何一处都会静默失败——没有报错，没有提示，插件就是不生效。这是离线安装最常被忽略的细节。
