Package Control 是 Sublime Text 的包管理框架而非插件；正确安装方式仅两种：控制台执行带哈希校验的 HTTPS 脚本，或手动将 .sublime-package 文件拖入 Installed Packages/ 目录；验证需重启后执行 Package Control: List Packages 和 Install Package 命令。
Package Control 不是插件，是 Sublime Text 的包管理框架。没它，Ctrl+Shift+P 里根本搜不到 Install Package——所有“装了插件但用不了”的问题，八成卡在这一步。
控制台执行脚本是最稳安装方式
别下 ZIP、别解压、别拖进 Packages/ 目录——这些操作会破坏模块加载顺序，导致命令面板卡死或命令不识别。
正确做法只有一条：打开控制台（Ctrl + `），粘贴并执行官方最新脚本。2026 年 ST4 稳定版必须用带完整哈希校验的 HTTPS 版本：
import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedcf1dcaee' + 'ebe013ee18cced0ef93d5f746d80ef60'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s)' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)
- 必须一次性粘贴整段，不能删空格、不能拆行
- 哈希值
h是防篡改关键，旧脚本（如含st3字样）在 ST4 下会静默失败 - 执行后左下角出现
Package Control: Successfully installed Package Control才算真成功；只显示reloading plugin或无反应 = 失败 - 若报
CertificateError或URLError，不是脚本问题，而是 TLS 握手被拦截，该切手动方式
手动安装适用于网络/系统受限场景
当你遇到以下任一情况，就该放弃控制台脚本，改用手动：
- macOS 提示
Operation not permitted（沙盒阻止写入） - Windows 下
sublime.installed_packages_path()返回空路径 - 控制台明确报
ssl.SSLCertVerificationError
操作极简但路径必须精准：
- 关闭 Sublime Text
- 菜单 →
Preferences → Browse Packages…→ 向上退一级，进入Installed Packages/目录 - 下载
https://packagecontrol.io/Package%20Control.sublime-package（注意 URL 中空格已编码） - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/，不要解压、不要改名、不要放进Packages/ - 先清空该目录下所有含
Package Control字样的旧文件，避免哈希冲突
验证是否真正生效，别信 UI 残留
很多人看到 Preferences → Package Settings 里有菜单项就以为成了——那是旧版残留，不代表底层通道打通。
唯一可信验证方式只有两个命令，必须在重启 Sublime 后执行：
- 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入Package Control: List Packages→ 能执行并返回空列表（不是报错） - 再输入
Package Control: Install Package→ 左下角出现Fetching list of available packages（不是卡住、闪退或无响应）
如果任一命令报 command not found，说明 Package Control 根本没加载，得重试或检查代理配置。
首次使用卡住？不是插件问题，是 channel 加载超时
Package Control: Install Package 首次执行时，会并发请求 channel_v3.json 和上百个插件元数据。国内网络环境下常卡在“Fetching list…”不动，这不是插件本身的问题。
- 等满 5–10 秒再判断，别急着关窗口
- 公司/校园网屏蔽
packagecontrol.io？换手机热点重试 - 确认
Preferences → Package Settings → Package Control → Settings – User中"channels"是默认值："https://packagecontrol.io/channel_v3.json"，拼错或写成http都会导致静默失败 - 仍不行，执行
Package Control: Synchronize Packages强制刷新本地索引，比重启更有效
最易被忽略的一点：ST4 不自动重载 Python 插件模块，装完新插件后，部分功能（比如语法高亮切换）需手动重启才能生效。
