package control未出现需先确认是否加载:执行sublime.version()判断版本,st4需用含sha256校验的安装脚本;删净installed packages中相关文件后执行官网最新代码并彻底退出重启;“no packages available”实为channel地址不可达,应配置有效v3镜像地址并浏览器验证可访问;手动安装插件须严格区分.sublime-package放installed packages、解压文件夹重命名后放packages根目录;插件不生效常因ignored_packages屏蔽或未重启,离线更新需先删除旧版,系统时间误差超5分钟或输入法劫持ctrl+`亦会导致异常。

Package Control 命令根本没出现?先确认它是否真在运行
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control,如果一行结果都没有,说明它压根没加载进 Sublime 运行时——不是插件问题,是包管理器缺席。
打开控制台(Ctrl+`),执行 sublime.version():返回 4xxx 是 ST4,必须用带 hashlib.sha256 校验的安装脚本;返回 3xxx 建议升级,旧版 TLS 兼容性差,容易静默失败。
- 删净
Installed Packages/目录下所有含Package Control字样的文件(包括残留的Package Control.sublime-package) - 粘贴并执行官网最新 ST4 安装代码(含
sublime.installed_packages_path()调用),看到Success才算落盘成功 - 执行完必须彻底退出 Sublime(右键任务栏选「退出」,不是关窗口),再重启验证
“There are no packages available”?本质是 channel 地址打不开
这个提示和插件无关,只说明 Package Control 请求的插件列表 JSON 返回空或 404。国内用户几乎全卡在这步,浏览器里打不开 channels 地址,Sublime 就永远等不到数据。
打开 Preferences → Package Settings → Package Control → Settings – User,填入 2026 年实测有效的 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
手动安装插件后不生效?90% 是路径放错目录
Sublime 会静默跳过错误位置的文件,连控制台都不报错。关键不是“怎么复制”,而是“复制到哪”。
最可靠方法:菜单栏点击 Preferences → Browse Packages…,打开的文件夹就是唯一可信的加载目录。再按 Ctrl+` 输入 import sublime; sublime.packages_path() 可验证真实路径。
-
.sublime-package文件(如Emmet.sublime-package)→ 必须放进Installed Packages/目录,不解压、不改名、不嵌套子目录 - GitHub 下载的 ZIP 解压后得到的文件夹(如
Emmet-master)→ 重命名为规范名(如Emmet,首字母大写、无空格、无中文、无点号、无-master后缀),整个文件夹拖进Packages/根目录顶层 - 千万别把
.sublime-package文件拖进Packages/,也别把解压后的文件夹扔进Installed Packages/
插件命令搜不到、快捷键无效?检查 ignored_packages 和重启
手动放完文件后重启 Sublime,仍看不到插件菜单或功能,大概率不是安装失败,而是被 Sublime 主动忽略。
打开 Preferences → Settings,看右侧用户配置中是否有 "ignored_packages" 字段。如果刚装的插件名(比如 "GitGutter")出现在这个列表里,它就会被静默屏蔽。
- 删掉对应项,或整行注释掉,保存后必须重启 Sublime 才生效
- 某些插件(如
Origami、SideBarEnhancements)需要额外启用命令面板里的初始化项,不是放进去就自动弹窗 - 离线更新插件时,先关闭 Sublime,进
Packages/删掉整个旧插件文件夹,再放新版本
最容易被忽略的点:系统时间误差超过 5 分钟会导致 SSL 验证失败,控制台报 ssl.CertificateError 时先校准系统时间;还有 QQ 输入法等第三方软件会劫持 Ctrl+` 快捷键,导致控制台打不开——得先去输入法设置里禁用该热键。











