package control 必须先安装,否则所有插件操作无效;它是 sublime text 唯一官方支持的包管理框架,未安装则 install package 不可用、手动拖入不生效、菜单项不显示,且 st4 用户必须使用官网最新脚本并确保网络畅通或手动安装至 installed packages/ 目录。

Package Control 必须先装,否则所有插件操作都无效
Sublime Text 本身不带插件管理能力,Package Control 是唯一被官方和社区长期维护的包管理框架。没它,Ctrl+Shift+P 里搜不到 Install Package,手动拖文件进 Packages/ 目录也大概率不生效——配置不加载、命令不注册、Preferences → Package Settings 里根本不会出现对应项。
常见误区:
• 菜单里看到 Package Control 选项 ≠ 它能联网或执行命令
• Preferences → Package Control 这个菜单项只有真正装好后才出现,别指望用它来“启动安装”
• ST4 用户若误用 ST3 的旧脚本(比如含 urllib2),会直接报 ModuleNotFoundError: No module named 'urllib2'
- 必须用
Ctrl+`(反引号)呼出控制台,粘贴官方脚本并回车 - ST4 唯一可靠脚本是官网当前提供的
https://packagecontrol.io/installation.py内容,不要复制任何带哈希校验或sublime.wbond.net的旧链接 - 执行后等满 5 秒再判断:左下角弹出
Package Control: Successfully installed Package Control才算真成功;只显示reloading plugin或无反应,基本是网络超时或证书拦截,应切手动方式
手动安装 Package Control 绕过网络限制
国内直连 packagecontrol.io 不稳定,科学上网不是可选项,而是硬性前提;但若无法实现,手动安装是唯一可行路径,且比反复重试控制台更可靠。
关键动作必须严格:
- 关闭 Sublime Text 全进程(Windows 任务管理器杀掉所有
sublime_text.exe和subl.exe) - 打开
Preferences → Browse Packages…,关掉窗口后向上退一级,进入Installed Packages/目录(不是Packages/) - 访问
https://packagecontrol.io/Package%20Control.sublime-package下载文件(注意 URL 中有空格编码,别手输错) - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/——不改名、不解压、不放进Packages/ - 重启前清空
Installed Packages/里所有含Package Control字样的残留文件,否则旧版本会劫持命令通道
装插件卡在 “Installing…” 的真实原因
Ctrl+Shift+P → Install Package 后弹窗空白、长时间转圈,99% 是网络问题,不是插件源挂了,也不是你搜错了名字。
Package Control 默认走 HTTPS 请求 https://packagecontrol.io,它不读系统代理,也不支持配置镜像源。所谓“换源”“改 hosts”“本地缓存”全是无效操作。
- 科学上网是唯一可靠解法;没条件就只能手动下载 ZIP 包
- 手动安装:去插件 GitHub/Gitcode 页面下载
xxx-master.zip,解压后整个文件夹重命名为插件名(如BracketHighlighter),丢进Packages/目录(不是Installed Packages/) - 插件名大小写敏感:
ConvertToUTF8写成converttoutf8就搜不到;ChineseLocalizations拼错一个字母,汉化也不会生效 - 部分插件(如
LSP-pyright)依赖语言服务器二进制文件,首次安装需联网下载,手动放 ZIP 无法跳过这步
验证是否真生效,只认两个硬指标
别信菜单有没有、界面有没有变化,只看这两件事能不能做:
-
Ctrl+Shift+P输入Package Control: List Packages,能执行并返回已安装插件列表 -
Preferences → Package Settings里出现Package Control项,点开能看到设置内容
如果其中任一失败,说明 Package Control 没跑起来——不是插件问题,是框架层卡死。这时候重装插件毫无意义,必须回到第一步重装框架本身。
最容易被忽略的是:ST4 用户误用 ST3 脚本、手动安装时拖错目录、残留旧版 Package Control 文件未清空。这三个点占全部失败案例的 80% 以上。











