package control 是 sublime text 的插件加载器而非普通插件，负责初始化 python 运行环境、注册命令与事件；缺失它则所有插件仅是静态文件。
Package Control 不是插件，是加载器
很多人卡在“点了 Install Package 没反应”，本质是因为把 Package Control 当成了普通插件——它实际是 Sublime Text 的 Python 插件运行时环境补丁。没有它，sublime_plugin 模块无法注册命令、无法监听事件、无法加载其他插件的 .py 文件。
ST4 启动时会扫描 Packages/ 目录下的所有子目录，但只加载含 sublime-package 或含 __init__.py 的目录；而 Package Control 必须先让这个加载机制本身活过来，否则后续所有插件都只是文件，不是代码。
- 手动拖进
Installed Packages/的Package Control.sublime-package文件，会在首次启动时被解压到Packages/Package Control/并触发plugin_loaded()初始化 - 控制台执行失败后残留的
Package Control目录（哪怕空着）会阻塞新版本加载，必须删干净再重装 - macOS 上若用 Homebrew 安装过旧版 ST，
~/Library/Application Support/Sublime Text/Packages/可能残留冲突路径，优先清空该目录下所有Package Control*条目
Install Package 命令背后是仓库同步 + 本地缓存
Package Control: Install Package 不是实时爬网页，而是先拉取 channel.json（默认从 https://packagecontrol.io/channel_v3.json），解析出插件元数据，再比对本地 cache/ 目录判断是否需要更新索引。网络不通、证书错误、DNS 污染都会导致“Loading packages”卡住不动，而非报错。
常见假成功现象：命令面板里能搜到插件名，但选中后无任何状态栏提示、插件目录没生成——说明索引加载了，但插件 ZIP 下载环节静默失败。
- 强制刷新缓存：按
Ctrl+Shift+P→ 输入Package Control: Synchronize Repositories，等右下角弹出 “Synchronized 1 repository” - 查看真实错误：打开控制台（
Ctrl+`），再执行Install Package，失败时会有urllib.error.URLError或ssl.SSLCertVerificationError输出 - 临时换源：编辑
Preferences → Package Settings → Package Control → Settings – User，添加"channels": ["https://ghproxy.com/https://raw.githubusercontent.com/wbond/package_control-channels/master/channel_v3.json"]
插件安装后不生效？检查三个加载节点
一个插件从下载完成到可用，要经过三道关卡：文件落地 → Python 模块导入 → 命令/事件注册。任一环节断开，就会出现“已安装但没反应”的情况。
比如 GitGutter 安装后不显示行边栏图标，大概率不是插件问题，而是 Git 可执行文件路径未配置或权限拒绝访问；Emmet 按 Tab 没展开，可能是语法作用域没匹配上（当前文件未识别为 source.html）。
- 确认文件落地：打开
Preferences → Browse Packages…，看对应插件名目录是否存在，且含.py或.sublime-settings文件 - 检查模块导入：控制台执行
import git_gutter; print(git_gutter.__file__)，若报ImportError，说明路径或依赖缺失 - 验证命令注册：按
Ctrl+Shift+P输入插件名关键词，如GitGutter，应能列出GitGutter: Diff等命令；若无，说明plugin_loaded()未执行或中途异常退出
手动安装插件时最容易漏掉的一步
手动安装 ≠ 把 ZIP 解压进 Packages/ 就完事。Sublime 要求插件根目录必须包含 __init__.py 或 .sublime-package，且不能有多余嵌套层级。
典型翻车操作：下载 GitHub 上的插件 ZIP，直接双击解压，得到 username-repo-abc123/ 文件夹，再把这个文件夹整个拖进 Packages/ ——结果 Sublime 加载的是空目录，因为真正代码在子目录里。
- 正确做法：解压后，只把最内层含
.py文件的文件夹（通常和仓库名同名）拖进Packages/，不要保留外层版本号或用户命名前缀 - 更稳方式：用命令行解压并重命名，例如
unzip emmet-sublime-master.zip && mv emmet-sublime-master/ Emmet，再移动Emmet/到Packages/ - 验证是否可加载：重启 Sublime 后，控制台执行
sublime.find_resources("*.py")，返回列表里应包含该插件路径
真正难的从来不是“怎么点”，而是当 Install Package 卡住、插件不响应、控制台没报错时，你能不能快速定位是网络层、缓存层、加载层还是插件自身逻辑出了问题。每个环节都有明确可观测的信号，别猜，去查。
