最可靠安装方式是执行官方python控制台脚本;若失败则手动下载.sublime-package文件拖入installed packages目录,切勿解压或改名,最后通过命令面板验证是否生效。

直接执行控制台脚本是最可靠安装方式
Package Control 不是普通插件,而是 Sublime Text 内置的包管理框架——没它,Ctrl+Shift+P 里根本搜不到 Install Package。所有“下载 zip 解压到 Packages 目录”的做法都容易失败,因为路径错位、权限不足或 Python 模块加载顺序问题会导致命令面板卡死、菜单项不出现。
正确做法只有一条:用官方最新 Python 脚本直连安装。2026 年当前最稳的命令是:
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))
- 按
Ctrl+`(反引号)打开控制台,粘贴后回车 - 状态栏出现
Package Control: Successfully installed Package Control才算真成功 - 若只显示
reloading plugin或无反应,不是装好了——大概率是网络超时或 TLS 握手失败,等满 5 秒再判断 - 别复制旧网页上带版本号的脚本(比如含
st3或st4字样的),那些在 ST4 最新版已失效
HTTPS 失败时换手动安装(绕过代理/SSL/沙盒限制)
macOS 提示 Operation not permitted、Windows 返回空 sublime.installed_packages_path()、控制台报 CertificateError 或 URLError,说明脚本被系统或网络策略拦截。这时必须切手动方式,且不能乱放文件。
- 关闭 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 Text 后,按
Ctrl+Shift+P,输入Package Control: List Packages - 如果弹出列表(哪怕只有 0 个包),说明 Package Control 已加载并联网成功
- 若提示
command not found,或输入Package Control后无任何补全,说明安装失败,需重试或检查网络代理设置 - 首次运行
Install Package会卡几秒——这是在拉取远程仓库索引,不是卡死,别急着关面板
装完之后第一件事:同步仓库 + 安装中文支持
刚装好的 Package Control 默认只缓存了极简元数据,不立刻同步仓库,会导致搜不到插件。另外,ST 原生界面是英文,中文用户容易误判功能位置。
- 先运行
Package Control: Synchronize Packages,强制刷新本地仓库缓存 - 再运行
Package Control: Install Package,搜ChineseLocalizations并安装 - 安装后无需重启,但部分菜单文字要等下次打开命令面板才刷新
- 后续装
Emmet、GitGutter等插件,都走同一套流程,不用再配任何东西
最容易被忽略的是:第一次 Install Package 后没等“Loading packages”结束就盲目搜索,结果搜不到任何插件——其实只是仓库还没载入完成。耐心等那几秒,比反复重装更省时间。











