package control命令面板搜不到说明其未加载,根本原因是版本脚本错配、ignored_packages屏蔽或路径错误;需先确认st3/st4版本并执行对应官方脚本,检查ignored_packages配置,确保.sublime-package放installed packages/、解压插件放packages/根目录。

Package Control命令面板搜不到
说明它压根没加载进运行时,不是网络慢、不是插件少,是Sublime启动时连Package Control都没认出来。别急着换源或配代理。
按Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control——如果一行都不出来,就确认是这问题。
- 打开菜单 Help → About Sublime Text,看清楚是
ST3还是ST4(Build ≥ 4126 才算 ST4) - 按
Ctrl+`呼出控制台,粘贴对应版本的官方安装脚本:ST4用urllib.request版,ST3用urllib2旧版 - 执行后必须看到
Success或类似Package Control installed的输出;如果一闪而过、报ModuleNotFoundError: No module named 'urllib.request',就是版本错配 - 装完必须彻底退出 Sublime(右键任务栏选「退出」,不是关窗口),再重启验证
Settings – User里禁用了 Package Control
这是最隐蔽也最常被忽略的坑:插件明明装好了,但菜单和命令面板全消失,原因可能就藏在你自己的配置里。
打开Preferences → Settings – User,检查有没有这行:
"ignored_packages": ["Package Control"]
如果有,直接删掉"Package Control"这个字符串,保存文件。重启 Sublime 即可恢复。
- 这个字段常见于汉化版、旧版备份迁移、或手动优化时误加
- 哪怕
Package Control.sublime-package文件在Installed Packages/目录下,只要被ignored_packages列表罩住,Sublime 就会彻底跳过加载 - 顺便检查该设置里是否还有其他插件名被误加进去,比如
"EmmyLua"、"BracketHighlighter",一并清理
There are no packages available
命令能搜到、菜单也出来了,但点Package Control: Install Package后只显示空列表,问题出在索引源——不是插件没了,是 Sublime 拿不到列表。
打开Preferences → Package Settings → Package Control → Settings – User,确认"channels"是个数组,且至少含一个可用的 v3 地址,例如:
"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]
- 把该 URL 粘到浏览器里直接访问,能加载出完整 JSON 才算有效;打不开就换网络、关杀毒软件(火绒/360 常静默拦截
urllib请求) - 别用博客里抄的旧链接,比如某些 php.cn 的 channel 地址在 2026 年已全部
404 - 如果控制台报
schema_version mismatch,说明用了 v2 channel 匹配新版 Package Control,必须统一用channel_v3.json - 改完必须重启 Sublime —— 设置不会热重载
插件装上了但命令面板找不到、快捷键无效
不是没装成,是被 Sublime 主动忽略了。常见于路径放错、ignored_packages屏蔽、或依赖模块缺失。
- 检查
Preferences → Settings – User中是否有"ignored_packages": ["xxx"],刚装的插件名在里面就会被静默屏蔽 - 确认插件类型:
.sublime-package文件必须放进Installed Packages/目录;ZIP 解压后的文件夹必须整体放进Packages/(不能嵌套子目录) - 依赖报错如
ImportError: No module named 'mdpopups',说明插件需要的底层模块没装对——Sublime 的 Python 环境完全隔离,pip install无效,所有依赖必须以.sublime-package格式手动放对位置 - 插件文件夹命名必须严格匹配仓库名,不能有空格、中文、特殊字符,也不能是
MyPlugin-master这类 GitHub 下载名
最容易被忽略的是:插件路径放对了、ignored_packages清干净了、channels也换了,但没彻底退出再重启——Sublime 不会动态重载插件注册表,只靠“关窗口”不行。











