Sublime Text需按版本手动安装Package Control:v3用旧脚本,v4用新脚本;通过Help→About确认版本,用Ctrl+`调出控制台执行对应命令,成功后重启并验证Ctrl+Shift+P是否出现Package Control选项。

Sublime Text 默认不带 Package Control,必须手动安装,且不同版本的 Sublime(3 / 4)对应不同的安装脚本,用错会导致 Package Control 不加载或报错。
确认 Sublime Text 版本再选安装方式
打开 Sublime Text → 菜单栏 Help → About Sublime Text,看顶部显示是 Sublime Text 3 还是 Sublime Text 4。两者安装命令完全不同:
-
Sublime Text 3:必须用 Python 3.3 兼容的旧版安装脚本(官方已归档) -
Sublime Text 4:必须用新脚本,否则会卡在 “Installing Package Control” 状态不动 - 如果装完后按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)没反应,大概率是版本不匹配
用控制台执行安装命令(最稳)
别依赖第三方一键安装包,直接调出 Sublime 控制台(Ctrl+` 或 Cmd+`),粘贴对应命令:
- Sublime Text 4:
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) - Sublime Text 3:
import urllib.request,os,hashlib; h = 'bf11abc32606e6b559e4c226611e854d' + '399631394886e2e64610b59940479152'; 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) - 执行后无报错、控制台末尾出现空行,就说明写入成功;关掉控制台,重启 Sublime
验证是否装好 & 常见失败信号
重启后按 Ctrl+Shift+P,输入 Package Control,应立刻出现下拉菜单(如 Package Control: Install Package)。若没反应或提示 command not found:
- 检查
Preferences → Browse Packages…打开的目录里,是否存在Package Control.sublime-package文件(不是文件夹) - 若存在但无效,可能是网络问题导致下载的包损坏 —— 手动删掉该文件,重跑控制台命令
- macOS 上如果用 Homebrew 安装的 Sublime,有时会因权限问题无法写入
Installed Packages目录,需改用拖拽方式安装(见下条)
备用方案:手动下载 + 拖入安装(绕过网络校验)
当控制台命令反复失败(尤其公司内网/代理环境),可手动操作:
- 浏览器访问 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445,直接下载文件
- 打开
Preferences → Browse Packages…,向上一级进入Installed Packages文件夹(不是Packages) - 把下载好的
Package Control.sublime-package文件拖进去,重启 Sublime - 注意:这个文件名不能改,也不能解压,必须保持原扩展名和原始二进制内容
真正容易被忽略的是:Sublime 启动时会扫描 Installed Packages,但不会热重载刚放进去的包 —— 一定得重启,而不是仅关闭再打开窗口。










