Package Control 显示“No packages available”根本原因是网络不通导致无法获取channel_v3.json,需更换镜像地址或手动升级至v4.0.0+;插件不生效多因路径错误、ignored_packages配置或缺失初始化命令;自动更新需同时启用auto_upgrade和enable_upgrade_check。

Package Control 显示 “No packages available” 怎么办
根本原因几乎都是网络不通——不是插件坏了,而是 Sublime 拿不到 channel_v3.json。默认地址 https://packagecontrol.io/channel_v3.json 在国内常被 DNS 污染、TLS 握手超时或 JSON 被截断,导致控制台静默失败,只显示“Loading…”然后消失。
直接验证:打开命令面板 Ctrl+Shift+P(macOS 是 Cmd+Shift+P),输入 Package Control: Install Package,如果列表空白,就说明通道失效。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 把
"channels"改成可用镜像,例如:{"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]} - 保存后不用重启,立刻再试
Package Control: Install Package;如果仍卡住,换另一个镜像(如https://ghproxy.com/https://raw.githubusercontent.com/.../channel_v3.json)或走离线路径
手动更新 Package Control 本体为什么必须做
旧版 Package Control(v3.x 或更早)用的是 Sublime 自带的 Python 2.7 环境 + 过期证书链,遇到 macOS 12+、Windows 11 或企业代理就会报 certificate_verify_failed。这不是配置问题,是底层下载器已不兼容现代 TLS。
官方早已停止对 v3 的维护,v4.0.0+ 才支持完整证书验证和 HTTP/2。自动更新机制在此类环境下大概率失效,必须手动升级。
- 关闭 Sublime Text
- 进入
Packages目录:
– macOS:~/Library/Application Support/Sublime Text/Packages/
– Windows:%APPDATA%\Sublime Text\Packages\
– Linux:~/.config/sublime-text/Packages/ - 删掉整个
Package Control文件夹(不是Package Control.sublime-package) - 打开 Sublime →
View → Show Console,粘贴官网最新安装脚本(来自https://packagecontrol.io/installation的 Manual Installation 区块),回车执行
插件装了但不生效?检查 ignored_packages 和文件夹命名
手动丢进 Packages/ 目录的插件没反应,90% 是路径或命名错误。Sublime 不报错,只是默默忽略。
- 确认插件文件夹名和官网一致:比如
https://packagecontrol.io/packages/SideBarEnhancements,解压后必须重命名为SideBarEnhancements(去掉-master、-main等后缀,大小写敏感) - 别放进
Installed Packages/或Packages/User/子目录——只放Packages/根目录下 - 打开
Preferences → Settings – User,检查是否有"ignored_packages"字段,里面若含插件名(如"SideBarEnhancements"),删掉它 - 某些插件(如
Origami)需首次运行命令面板里的Origami: Initialize才激活,不是放完就自动工作
auto_upgrade 设为 true 却不自动更新?漏了 enable_upgrade_check
auto_upgrade 只控制“下载完成后是否自动安装”,而 enable_upgrade_check 才决定“要不要联网检查更新”。两者都为 true 才构成完整自动更新链路。
它们必须同时出现在 Package Control.sublime-settings(用户配置)里,且语法合法(英文双引号、无尾逗号、大括号闭合)。
- 命令面板输入
Package Control: Settings – User - 确保包含这两项:
"auto_upgrade": true, "enable_upgrade_check": true
- 注意:检查频率固定为每 12 小时一次,不可调;想立即触发,运行
Package Control: Upgrade Package - 部分插件(如
Emmet)自带"check_for_updates": true设置,优先级高于全局配置,需单独进Preferences → Package Settings → Emmet → Settings – User核对
最易被忽略的是 macOS 上的「完全磁盘访问」权限——没给 Sublime 授权,它连自己的插件目录都读不了,升级会静默失败,连日志都不打。Windows/Linux 则要留意 /proc/sys/fs/inotify/max_user_watches 是否耗尽,否则解压阶段就卡住。


















