package control是sublime text内置包管理框架而非普通插件，唯一可靠安装方式是执行官方python脚本；手动拖放或解压易导致命令面板失效、路径错位或加载失败。
Package Control 不是插件，而是 Sublime Text 的包管理框架——没它，Ctrl+Shift+P 里根本搜不到 Install Package。直接执行官方 Python 脚本是最可靠方式，其他方法大概率失败。
为什么控制台粘贴脚本是唯一推荐路径
所有“下载 zip 解压到 Packages 目录”或“拖 .sublime-package 文件进目录”的做法，都绕过了 Sublime 的模块加载机制。结果常是：Preferences → Package Settings 里有残留菜单项，但命令面板不识别 Package Control 命令，甚至导致整个 Ctrl+Shift+P 卡死。
- Sublime Text 4（2026 年主流版本）必须用带完整哈希校验的新脚本，旧版脚本会卡在
Installing Package Control状态不动 - 脚本里硬编码的 SHA256 哈希值（如
h = '6f4c264a24d933ce70df5dedcf1dcaee...'）是防篡改关键，不能删、不能简写 - 如果控制台报
CertificateError或URLError，说明 TLS 握手失败，不是脚本问题，而是系统/代理拦截了 HTTPS 请求 - 执行后左下角没出现
Package Control: Successfully installed Package Control，就等于没装成——别信空行或reloading plugin日志
ST4 正确安装命令（2026 年实测有效）
打开 Sublime Text，按 Ctrl+` 呼出控制台，**严格复制以下整段代码，一次性粘贴并回车**：
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)
注意：
- 别用带
st3或st4字样的旧网页链接，那些已失效 - 别手动改
https为http——HTTP 已被 packagecontrol.io 强制重定向，反而触发更隐蔽的连接中断 - 执行后等满 5 秒再判断：无报错 + 控制台末尾为空行 + 左下角弹提示，三者缺一不可
安装后验证失败的常见原因
重启 Sublime 后，按 Ctrl+Shift+P 输入 Package Control: List Packages，如果提示 command not found 或无任何补全，说明安装未生效。此时不是重试脚本，而是检查这些点：
-
sublime.installed_packages_path()返回空值？macOS 可能因 SIP 限制无法写入，Windows 可能权限不足——这时必须切手动安装 - 手动安装时，文件必须放入
Installed Packages目录（不是Packages），且**不能解压、不能改名、不能加后缀**，只放原始Package Control.sublime-package - 首次运行
Package Control: Install Package会卡几秒，这是在拉取远程仓库索引，不是卡死；但如果超过 15 秒无反应，大概率是本地缓存损坏，需清空Cache/Package Control目录 - 装完立刻运行
Package Control: Synchronize Packages，否则插件列表为空——默认不自动同步
中文用户务必做的两件事
原生 Sublime 是英文界面，很多用户误以为功能缺失，其实是没找到入口：
- 先运行
Package Control: Install Package，搜ChineseLocalizations并安装——这是官方维护的中文语言包，不是第三方魔改 - 再运行
Package Control: Synchronize Packages，确保仓库元数据最新，否则搜Emmet或SideBarEnhancements会返回空 - 别跳过同步步骤：刚装好的 Package Control 默认只缓存极简元数据，不刷新就搜不到任何插件
最易忽略的一点：手动安装后，必须重启 Sublime 才能触发 installed_packages_path() 的真实路径解析——不重启，命令面板永远看不到 Package Control。
