Package Control 安装失败的典型现象是控制台仅显示 reloading plugin 或无反应、命令面板搜不到 Install Package、Package Settings 为空或残留旧项；根本原因是网络拦截或脚本失效，必须用2026年ST4专用命令手动执行并等待5秒，成功标志为状态栏提示“Successfully installed”，否则需严格按路径和文件名手动安装并同步仓库。
Package Control 安装失败的典型现象
按 Ctrl+` 打开控制台，粘贴脚本后回车，只显示 reloading plugin 或完全没反应；重启后 Ctrl+Shift+P 输入 Package Control: Install Package 没有补全、提示 command not found；Preferences → Package Settings 里看到空条目或旧版残留项——这些都不是安装成功，只是界面缓存干扰。
必须用官方最新 Python 脚本直连安装
2026 年 ST4（Sublime Text 4）已全面弃用 HTTP 和旧哈希校验逻辑，所有含 st3、st4 字样或指向 sublime.wbond.net 的脚本均已失效。当前唯一可靠命令是：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))
操作要点：
-
Ctrl+`打开控制台，整行粘贴，**回车后必须等满 5 秒再判断结果**——TLS 握手或 DNS 解析慢时，前几秒可能静默 - 成功标志只有一条：状态栏出现
Package Control: Successfully installed Package Control，不是弹窗、不是日志、不是菜单出现 - 若报
CertificateError、URLError或 macOS 提示Operation not permitted，说明系统拦截了 HTTPS 请求，此时必须切手动方式
手动安装时路径和文件名不能错半字
手动方式不是“随便拖个文件进去”，关键路径和命名必须精确：
- 先在控制台执行
sublime.installed_packages_path()查真实路径，别信网上说的“资源库/Application Support/Sublime Text 3”——ST4 默认是Sublime Text（无版本号） - 下载地址必须是
https://packagecontrol.io/Package%20Control.sublime-package（注意空格被编码为%20） - 文件名必须严格为
Package Control.sublime-package，**不能解压、不能改后缀、不能加数字或下划线** - 扔进
Installed Packages/后必须重启 Sublime，否则插件加载器根本不会扫描它
装完立刻验证并同步仓库，否则搜不到插件
很多人装完就去搜 Emmet，结果列表为空——因为默认不拉取远程索引。必须按顺序执行：
- 重启后，
Ctrl+Shift+P输入Package Control: Synchronize Packages，等右下角提示完成 - 再输入
Package Control: Install Package，首次运行会卡 3–8 秒（这是在下载 10MB+ 的仓库元数据，不是卡死） - 中文用户建议紧接着装
ChineseLocaliz，否则命令面板里的英文选项容易误判，比如把Set Syntax看成无关项
最常被跳过的一步是同步仓库：没这步，Install Package 列表永远只有本地已装插件，远程插件名一个都搜不到。
