package control显示“no packages available”或超时，根本原因是未获取channel_v3.json，需更换为清华或gitee镜像源（如"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json"），保存后重启sublime生效。
Package Control 显示 “There are no packages available” 或控制台反复报 Operation timed out，说明它根本没拿到 channel_v3.json —— 不是插件坏了，也不是你手误，而是网络链路卡在了第一步。
为什么改 hosts 或开代理没用
Package Control 不走系统代理，也不读 HTTP_PROXY 环境变量；改 hosts 只能缓解 DNS 污染，但对 TLS 握手失败、CDN 返回截断 JSON、或 raw.githubusercontent.com 被限流完全无效。浏览器能打开 https://packagecontrol.io/channel_v3.json，Sublime 控制台里执行 urllib.request.urlopen 却超时，就是典型的表现。
直接换可用镜像源（推荐首选）
最稳的解法是把"channels" 指向一个国内可直连、内容完整、更新及时的 channel_v3.json：
打开 Preferences → Package Settings → Package Control → Settings – User
填入以下内容（任选其一，清华源最稳，Gitee 源备用）：
{"channels": ["https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json"]}{"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]}
保存后必须重启 Sublime Text —— 设置不热重载，Ctrl+Shift+P 里输 Package Control: Install Package 看是否立刻列出插件。
注意：https:// 不可省略；/raw/master/channel_v3.json 路径段不能少；别用已失效的博客镜像（如 php.cn 或旧 GitHub Gist）。
本地 file:// 方案（适合彻底断网或企业内网）
如果连镜像源都不可靠，就用本地文件：- 从可信链接（如清华镜像页或 Gitee 仓库）下载
channel_v3.json，存为绝对路径，例如C:/sublime/channel_v3.json（Windows）或/Users/you/sublime/channel_v3.json（macOS） - 确保路径不含空格、中文，且文件权限允许
Sublime读取 - 在
Settings – User中写："channels": ["file:///C:/sublime/channel_v3.json"]（Windows 注意斜杠方向）或"channels": ["file:///Users/you/sublime/channel_v3.json"]（macOS）
别漏掉 file:// 协议前缀和三个斜杠；改完一样要重启。
手动安装插件时命名必须严格匹配
即使通道通了，Install Package 成功后插件不生效，大概率是文件夹名错了：
- 去
https://packagecontrol.io/packages/XXX页面点 “Source”，进 GitHub 仓库 - 点
Code → Download ZIP，解压后默认是XXX-master或XXX-main - 必须重命名为
XXX（纯英文、大小写敏感、无后缀、无连字符） - 放进
Packages目录对应路径：Windows 是%APPDATA%\Sublime Text 4\Packages\，macOS 是~/Library/Application Support/Sublime Text 4/Packages/
名字错一个字母，Sublime 就当它不存在——不会报错，也不会加载命令或设置项。
