Package Control手动安装失败主因是路径错放、文件改名或解压、旧残留未清；必须放入Installed Packages/目录，保留完整文件名，且删除所有含“Package Control”字样的旧文件。
Package Control手动安装失败的三个关键位置
手动安装失败，90%是因为这三个地方出错：路径进错目录、文件被改名或解压、旧残留没清干净。不是脚本问题，是操作细节卡死。
-
Installed Packages/和Packages/是平级目录，必须拖进前者，不是后者 -
Package Control.sublime-package文件后缀名必须完整保留，不能改成.zip或删掉.sublime-package - 进
Installed Packages/目录后，先删掉所有含Package Control字样的文件（包括Package Control.sublime-package.old这类隐藏残留）
怎么确认 Sublime Text 版本并选对下载链接
ST4 和 ST3 的 Package Control.sublime-package 文件不通用，混用会导致命令面板里搜不到 Package Control: Install Package。
- 打开
Help → About Sublime Text，顶部显示Sublime Text 4就用这个链接：https://packagecontrol.io/Package%20Control.sublime-package - 显示
Sublime Text 3则必须用旧版归档地址（官网已不直接展示，需从历史文档提取哈希校验值） - 别点第三方博客里带
st3或st4后缀的下载链接——2026 年这些大多已失效或指向 404
重启后验证是否真生效，而不是看菜单有没有选项
很多人看到 Preferences → Package Settings → Package Control 就以为装好了，其实那是旧版残留 UI，完全不可信。
- 真正生效的唯一标志：按
Ctrl+Shift+P（Mac 为Cmd+Shift+P），输入Package Control: List Packages，回车后弹出一个空列表（哪怕没装任何插件） - 如果输入
Package Control后没有任何命令补全，说明框架根本没加载，得重来 - 首次运行
Package Control: Install Package卡在 “Loading packages” 超过 10 秒，大概率是 channel 请求超时，不是插件问题，检查代理或换网络环境再试
控制台脚本执行后只显示 reloading plugin，算成功吗
不算。这是最常见的误判点——reloading plugin 只表示 Python 模块开始加载，不代表 Package Control 已就绪。
- 必须等状态栏出现
Package Control: Successfully installed Package Control才算完成 - 如果粘贴脚本后黑屏 5 秒没反应，别急着关控制台，TLS 握手慢时提示会延迟出现
- 报
CertificateError或URLError，说明网络层拦截了 HTTPS 请求，此时硬改https为http没用（packagecontrol.io强制重定向），直接切手动更省时间
复杂点在于“生效”和“看起来有”之间隔着一层加载机制；容易被忽略的是，哪怕文件拖对了、后缀保住了、旧文件删干净了，第一次 Install Package 仍可能因仓库通道不通而卡住——那不是你装错了，是它还没连上。
