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,否则 Preferences → Package Control 菜单项也不会出现
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",一并清理。
Install Package 空列表:“There are no packages available”
命令能搜到、菜单也出来了,但点 Package Control: Install Package 后只显示空列表,问题出在索引源——不是插件没了,是 Sublime 拿不到 channel_v3.json。
- 打开 Preferences → Package Settings → Package Control → Settings – User,确认
"channels"是个数组,且至少含一个可用的 v3 地址,例如:"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]
- 把该 URL 粘到浏览器地址栏访问,能返回合法 JSON 内容才算有效;打不开就换镜像,别硬等
- 更稳的方案是本地 channel:浏览器访问
https://packagecontrol.io/channel_v3.json,右键“另存为”保存为纯文本(注意别带.txt后缀),例如存到C:/sublime/channel_v3.json;然后在 Settings – User 中写入绝对路径:"channels": ["C:/sublime/channel_v3.json"]
- 改完配置后必须重启 Sublime,否则不生效;若仍为空,检查 JSON 文件是否能被正常读取(无乱码、无 BOM 头)
插件装上了却不生效,控制台报 ImportError
典型现象是命令面板搜不到插件命令、设置项不出现、快捷键无响应,控制台反复刷出 ImportError: No module named 'mdpopups'。这不是插件坏了,是它依赖的模块没装对。
- Sublime 的 Python 环境完全隔离,
pip install无效,所有依赖必须以.sublime-package形式放进Packages/目录 - 去对应仓库 Releases 页面下载官方发布的
mdpopups.sublime-package(不是源码 ZIP),放入Packages/ - 同理,
python-jinja2要用 skuroda 维护的 Sublime 分支,pygments要下完整版pygments.sublime-package - 装完别忘了重启,否则不会重新扫描依赖
路径和格式错一点,Sublime 就当它不存在——.sublime-package 必须放 Installed Packages/,解压后的插件文件夹必须整体放 Packages/ 根目录,不能嵌套、不能改名。











