package control命令面板不出现说明其未加载,根本原因是package control.sublime-package文件放错目录(应放入installed packages/而非packages/)、未完全退出重启或残留旧文件冲突;控制台报sslcertverificationerror是内置证书过期所致,需手动更新cacert.pem;install package空白则因channel源失效,须改用清华镜像并重启。

Package Control命令面板不出现,说明根本没加载
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)搜不到 Package Control: Install Package,不是插件装不上,是 Package Control 连运行时都没进。别急着换源或重试安装,先确认它是否存在:
- 打开控制台(
Ctrl+`),执行sublime.version():返回4xxx是 ST4,必须用含urllib.request和hashlib.sha256的脚本;返回3xxx才能用旧版 - 执行
sublime.installed_packages_path(),去文件系统里检查该路径下的Installed Packages/目录,看有没有Package Control.sublime-package - 如果有但命令仍不出现,大概率是旧残留干扰——删掉
Installed Packages/下所有含Package Control字样的文件(包括Package Control (old).sublime-package),再重跑最新脚本 - 重启必须是「完全退出」:Windows 右键任务栏图标选「退出」,macOS 菜单栏选「Sublime Text → Quit Sublime Text」,只关窗口无效
控制台执行脚本后静默失败或报错
粘贴官网脚本回车后,控制台没输出、闪退、或报 NameError: name 'urllib2' is not defined/ModuleNotFoundError: No module named 'urllib.request',说明版本和脚本严重 mismatch:
- ST4 用户绝不能用 ST3 脚本;ST3 用户也不能直接套用 ST4 脚本。务必去 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1 页面,按你当前的
sublime.version()结果,复制对应区块的「Manual Installation」代码 - 粘贴前,先在控制台敲
import urllib.request回车:报错就证明你手里的脚本根本不适配当前版本 - 别从网页截图、PDF 或博客复制脚本——容易带不可见字符(全角空格、零宽字符),导致 Python 解析失败;必须从官网页面直接复制整段
- 执行后没看到
Success或写入路径日志,代表文件根本没落盘,不算成功
装上了却提示 “There are no packages available”
命令面板能调出 Package Control: Install Package,但点击后卡在 “Loading…” 或直接显示空列表,问题不在 Package Control 本身,而在它依赖的插件源(channels)不通:
- 打开
Preferences → Package Settings → Package Control → Settings – User,确认"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 - 绝对路径引用本地文件时,斜杠要写成双反斜杠:
"C:\Users\xxx\channel_v3.json"
手动下载 .sublime-package 文件放错目录
手动下载 Package Control.sublime-package 后,放进错误目录会导致 Sublime 完全忽略它,且不报错、不提示:
- 必须放入
sublime.installed_packages_path()返回的路径下的Installed Packages/目录(不是Packages/!) - Windows 路径示例:
%APPDATA%Sublime Text 4Installed Packages - macOS 路径示例:
~/Library/Application Support/Sublime Text 4/Installed Packages/ - Linux 路径示例:
~/.config/sublime-text-4/Installed Packages/ - 放完后必须「完全退出并重启」,否则不会重新扫描该目录
最常被忽略的是:ST4 的 installed_packages_path() 和 ST3 不同,且 Installed Packages/ 和 Packages/ 是两个互不干涉的目录——放错一个字母、多一层子目录,就等于没装。











