package control插件无反应90%因channel加载失败或依赖缺失;需替换国内镜像、重启sublime、手动安装依赖包、校准系统时间及hosts,并确保文件路径和命名规范。

Package Control 装上了但插件没反应,90% 是 channel 加载失败或依赖缺失,不是插件本身坏了。
Package Control: Install Package 点开是空的
这是最典型的“没反应”现象,本质是 Sublime 拿不到插件列表,不是界面卡顿。控制台(Ctrl + `)通常不报错,但右下角状态栏可能显示 There are no packages available。
- 打开
Preferences → Package Settings → Package Control → Settings – User,确认"channels"字段已替换为国内镜像,例如:"https://gitee.com/akira-cn/package_control_channel/raw/master/channel.json" - 删掉旧的默认地址
"https://packagecontrol.io/channel_v3.json",它在国内基本不可用 - 保存后必须重启 Sublime —— 设置不会热重载,改了也不生效
- 仍为空?按
Ctrl + Shift + P输入Package Control: Synchronize Packages强制刷新缓存,等待状态栏出现Finished synchronizing packages
插件装上后命令面板搜不到、快捷键无效
说明插件 Python 文件加载失败,常见于依赖模块缺失。Sublime 的 Python 环境完全隔离,pip install 无效,所有依赖必须以 .sublime-package 格式手动放对位置。
- 打开控制台,看是否有类似
ImportError: No module named 'mdpopups'的报错 —— 这就是根因 - 去对应仓库 Releases 页面下载官方发布的
mdpopups.sublime-package(不是源码 ZIP),放入Packages/目录(不是Installed Packages/) - 同理,
python-jinja2必须用 skuroda 维护的 Sublime 分支;pygments要下完整版pygments.sublime-package - 确认插件文件夹命名规范:不能有空格、中文、特殊字符;不能是
MyPlugin-master这类 GitHub 下载名,得重命名为MyPlugin
安装过程卡住、控制台无输出或报 SSL 错误
这类“没反应”其实是网络层阻断,常见于 HTTPS 握手失败或 DNS 污染,和插件逻辑无关。
- 先运行
print(sublime.version())确认版本:ST3 建议 Build ≥ 3176,否则内置 Python 缺 SNI 支持,所有 HTTPS 请求必挂 - 检查系统时间是否准确(偏差 >5 分钟会导致 TLS 验证失败),Windows 可在“设置→时间和语言”中开启自动同步
- 若报
CERTIFICATE_VERIFY_FAILED,不要设"ssl_verification": false,而是替换证书:下载最新cacert.pem,覆盖Packages/Package Control/certifi/cacert.pem - 仍失败?临时在系统
hosts文件里加两行:104.20.151.17 packagecontrol.io和199.232.68.133 raw.githubusercontent.com
手动安装 Package Control 后菜单里没有选项
脚本执行显示 Success 不代表 Package Control 已就绪,它必须被正确加载进插件系统。
- 确认文件放对路径:运行
print(sublime.installed_packages_path()),把下载好的Package Control.sublime-package直接丢进该路径(通常是Packages/Installed Packages/) - Sublime 不扫描子目录,也不接受重命名后的包文件 —— 文件名必须一字不差,且不能放在
Packages/User/或其他任意子文件夹下 - 必须重启 Sublime,仅刷新或重载插件无效
- macOS/Linux 用户注意权限:检查文件是否被系统拦截(如 Gatekeeper),可尝试右键用「以管理员身份运行」启动
真正麻烦的点往往藏在细节里:系统时间不准、hosts 写错 IP、.sublime-package 放错目录、依赖模块版本不匹配……这些地方一错,整个流程就静默失败,连错误提示都不给。排查时别只盯着插件本身,先盯住 Package Control 的加载链路和网络通道。











