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",一并清理
channels 地址不可达导致“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 内容才算有效;打不开就换镜像,别等超时
- 绝对路径引用本地 channel 文件时,Windows 下要用双反斜杠:
"C:\Users\xxx\channel_v3.json" - 如果控制台报
schema_version mismatch,说明用了 v2 channel(如旧版packagecontrol.io/channel.json),必须换成channel_v3.json - 某些安全软件(火绒、360)会静默拦截 Python 的
urllib请求,关掉再试
手动安装插件却没生效
你拖了一个 .sublime-package 文件进去,或者解压了整个插件文件夹,但功能不出现——大概率是放错了目录。
务必通过菜单 Preferences → Browse Packages… 打开真实用户包目录,而不是靠记忆或路径猜测。常见错误位置:
- ❌ 错:放进
Installed Packages/目录(那是 Sublime 自动管理的压缩包存放地) - ❌ 错:放进
Packages/User/子目录(User 是配置专用,不加载插件) - ✅ 对:直接扔进
Packages/根目录,插件文件夹名必须与官方仓库名完全一致(大小写、连字符、空格都不能差) - 重启 Sublime 后,再检查
Preferences → Package Settings里有没有对应插件的子菜单
路径对、名字对、没被 ignored_packages 屏蔽,但还是没反应?那得查插件本身是否兼容当前 ST 版本,或者是否依赖其他插件(比如某些插件要求先装 Python 3 支持包)。











