package control离线安装必须将.sublime-package文件放入installed packages/目录而非packages/目录，否则因模块路径错误导致import失败；重启后方可正常调用命令。
Package Control 安装失败的典型表现
Sublime Text 启动后看不到 Package Control 菜单项，或执行 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）后搜不到 Package Control: Install Package，基本可以判定未成功加载。常见错误日志在 Sublime 控制台（Ctrl+`）里会显示类似：
ImportError: No module named 'package_control'
或更隐蔽的报错如：
error: Package Control: Error downloading package. URL error [Errno 1] _ssl.c:510: error:14077410:SSL routines:SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure
这说明不是“没装”，而是“装了但跑不起来”——尤其在国内网络环境下，SSL 握手失败、GitHub 域名解析异常、证书验证失败是离线安装前最常卡住的地方。
离线安装 Package Control 的正确路径
离线安装 ≠ 直接把 zip 解压进 Packages/ 目录。Package Control 是一个带自更新机制的 Python 包，必须满足两个硬性条件：文件结构完整 + 主模块可被 Sublime 的 Python 解释器 import 到。
- 从官方 GitHub Release 页面下载最新
.sublime-package文件（不是源码 zip），地址是：<a href="https://www.php.cn/link/8fa85083ec873a434d58d2b75f55ca07">https://www.php.cn/link/8fa85083ec873a434d58d2b75f55ca07</a>，找带Package Control.sublime-package后缀的资产（Asset） - 关闭 Sublime Text
- 手动将该文件复制到 Sublime 的
Installed Packages/目录下（不是Packages/） - Windows 路径示例：
%APPDATA%\Sublime Text\Installed Packages\ - macOS 路径示例：
~/Library/Application Support/Sublime Text/Installed Packages/ - Linux 路径示例：
~/.config/sublime-text/Installed Packages/ - 重启 Sublime，再按
Ctrl+Shift+P搜Package Control，应能出现全部命令
为什么直接放 Packages/ 目录会失效
Sublime 的加载机制区分两种包类型：
-
Installed Packages/下的.sublime-package文件会被解压缓存并优先加载，支持自动更新和依赖管理 -
Packages/下的文件夹是“用户包”或“开发中包”，Sublime 会原样导入，但 Package Control 的主入口package_control.py不在顶层，且含大量相对路径引用和资源加载逻辑，直接解压会导致import失败或图标/菜单注册不全
你可能会看到 Package Control 文件夹出现在侧边栏，但控制台报错：
reloading plugin Package Control.package_control Traceback (most recent call last): File "package_control in .../Installed Packages/Package Control.sublime-package", line 1, in <module> ImportError: No module named 'package_control'
这就是典型的路径错放导致的模块发现失败。
离线安装插件时仍需注意网络依赖
即使 Package Control 本身已离线装好，后续通过它安装其他插件（比如 Emmet、SideBarEnhancements）默认仍走 GitHub 或 Bitbucket 的原始仓库地址。若网络不通，会出现：
Package Control: The dependency 'mdpopups' could not be installed or updated
解决办法有两个：
- 提前下载好插件的
.sublime-package文件（同样来自其 Release 页面），手动丢进Installed Packages/ - 或修改 Package Control 的配置，强制使用镜像源（需在
Preferences → Package Settings → Package Control → Settings – User中添加）："channels": [ "https://ghproxy.com/https://raw.githubusercontent.com/wbond/package_control-channels/master/channel.json" ]
但注意：这个镜像地址本身也可能失效，且部分插件作者未将发布包同步到镜像，所以最稳的方式还是对关键插件做“双备份”——既配好 Package Control，又单独存一份 .sublime-package 文件。
Sublime 的插件生态看似简单，但它的加载链路比表面看起来更脆弱：一次路径错放、一个 SSL 版本不兼容、甚至系统时间偏差超过 5 分钟，都可能让 package_control 进不了 import 表。离线安装不是终点，而是把不可控变量收归可控的第一步。
