Package Control打不开即未安装或未加载,需确认ST4版本、用官网脚本安装或离线将.sublime-package放入Installed Packages/目录并完全退出后重启。

Package Control 打不开,基本就是没装上或根本没加载——不是插件问题,是包管理器本身缺失或损坏。离线安装不是“把文件丢进去就完事”,路径、命名、重启方式错一个,Sublime 就当它不存在。
Package Control: Install Package 命令完全不出现
这是最明确的信号:Package Control 没加载。控制台里大概率会报 ImportError: No module named 'package_control' 或静默无响应。
- 先确认你用的是 Sublime Text 4(ST4),ST3 用户建议升到 Build 3211+,否则内置 Python 的 SSL 支持可能直接拒绝连接
- 打开控制台(
Ctrl + `或Cmd + `),粘贴官网当前有效的安装脚本(务必从 packagecontrol.io/installation 页面「Manual Installation」区块复制整段import urllib.request,os,hashlib;开头的代码) - 如果执行后报
Error validating download (got xxx instead of yyy),别改哈希值,换新脚本重试——旧脚本里的 SHA256 已失效 - 若控制台卡住、无输出、或报
urllib.error.URLError,说明网络不通,跳过在线流程,直接走离线
手动放入 Package Control.sublime-package 后仍无效
离线安装失败,90% 是因为文件放错了目录。Sublime 不会扫描 Packages/ 下的 .sublime-package 文件,只认 Installed Packages/。
- 在控制台运行
print(sublime.installed_packages_path()),看真实路径(Windows 示例:%APPDATA%\Sublime Text 4\Installed Packages\;macOS 示例:~/Library/Application Support/Sublime Text 4/Installed Packages/) - 把下载好的
Package Control.sublime-package文件(必须是从 packagecontrol.io/Package%20Control.sublime-package 直接下载的,不是 GitHub 源码 ZIP)放进上面那个路径 - 必须「完全退出」Sublime:Windows 右键任务栏图标选「退出」,macOS 在菜单栏选「Sublime Text → Quit Sublime Text」,不能只是关窗口
- 重启后按
Ctrl+Shift+P输入Package Control: List Packages,能执行并返回空列表才算真正加载成功
装好了但 Install Package 点开空白或一直显示 “Loading…”
这说明 Package Control 跑起来了,但插件索引拉不下来——本质是 channels 地址失效或网络被拦,和 Package Control 本体无关。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 把
"channels"改成可用镜像,例如:["https://gitee.com/akira-cn/package_control_channel/raw/master/channel.json"] - 保存后重启 Sublime,再试
Package Control: Install Package;如果浏览器能打开这个 URL 并看到 JSON,说明地址有效 - 若仍卡住,临时删掉
Installed Packages/Package Control.sublime-package,重新下载、放入、重启——比修配置更快
插件手动安装后命令不生效、快捷键失灵
这不是 Package Control 的问题,而是插件本身被忽略或路径冲突。Sublime 加载插件时会严格检查命名和位置。
- 检查
Preferences → Settings右侧用户设置中是否含"ignored_packages",刚装的插件名(如"Emmet")如果在里面,就会被静默屏蔽 - 手动安装插件(非
.sublime-package格式)时,必须把解压后的文件夹重命名为官方名(比如EmmyLua-master→EmmyLua),大小写敏感,且直接丢进Packages/目录根下(不是Packages/User/或子目录) - 切忌在
Installed Packages/和Packages/中同时存在同名插件(比如既有EmmyLua.sublime-package,又有Packages/EmmyLua/文件夹),Sublime 会优先加载文件夹,但可能因路径引用错乱导致 import 失败
最易被忽略的一点:Sublime 的「退出」和「关闭窗口」是两回事。只要进程还在后台跑,缓存就不会清,Installed Packages/ 里的文件也不会被重新扫描。哪怕你点了几十次「关闭」,没真正退出,Package Control 就永远处于“假死”状态。











