package control未加载导致install package命令不出现，需先执行st4官方手动安装脚本并确认success或路径写入日志，失败则换源；“no packages available”是channel_v3.json加载失败，须配置有效gitee镜像地址并验证json可访问。
Package Control装不上，Install Package命令根本不出现
这不是网络慢的问题，是Sublime压根没加载Package Control。按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）搜Package Control，如果完全没结果，说明它连运行时环境都没进。
打开控制台（View → Show Console），粘贴ST4官方手动安装脚本，回车执行。看到Success或日志里写入installed_packages_path()返回的路径才算真正落盘成功。失败时别反复重试，直接切到换源步骤。
- 某些汉化版会删掉原始入口，建议用官网原版 + 中文语言包替代
- QQ、搜狗输入法常劫持
Ctrl+`快捷键，导致控制台打不开，先关掉输入法热键 - 装完必须彻底退出Sublime再重启，否则命令不会生效
“There are no packages available”不是插件问题，是channel_v3.json加载失败
这个提示本质是Package Control请求channels地址后返回空JSON或404，和你要装什么插件完全无关。国内用户90%卡在这步。
打开Preferences → Package Settings → Package Control → Settings – User，确认"channels"字段至少有一条有效地址，例如：
"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]
把该URL粘到浏览器里直接访问，能加载出完整JSON才算有效；打不开就换网络、关杀毒软件（火绒/360常静默拦截urllib请求）。
- 别用博客里抄的旧链接，2026年很多php.cn或CSDN上的地址已全部404
- 必须含
/raw/master/路径，结尾必须是/channel_v3.json，否则Sublime静默失败 - 如果控制台报
schema_version mismatch，说明用了v2 channel匹配新版Package Control，必须统一用v3
Unable to download XXX，优先调换downloader_precedence
Mac用户遇到下载超时，根本原因不是代理没配好，而是Sublime默认用urllib发起请求，而macOS上它常被系统策略限制或DNS解析异常。改用curl可绕过大部分底层问题。
在Settings – User中加入：
"downloader_precedence": { "osx": ["curl", "urllib"] }
Windows用户则应设为"windows": ["wininet"]，Linux用户可用["curl", "wget", "urllib"]。同时开启"debug": true，方便从控制台看具体卡在哪一步。
-
curl依赖系统已安装，macOS Monterey及以后版本自带，老系统需自行brew install curl - 别盲目加
http_proxy，Sublime不继承系统代理，且https_proxy必须写http://协议头，哪怕目标是HTTPS站点 - 端口必须和本地代理监听端口完全一致（Clash默认7890，但部分配置用7891或8080）
手动装插件时，Packages目录放错位置等于白干
手动安装不是“拖进去就完事”。插件文件夹或.sublime-package文件必须放在Packages目录根下，放错一层（比如进了子文件夹）或放错目录（比如丢进了Installed Packages），Sublime就完全无视。
路径位置因系统而异：
- Windows：
%APPDATA%\Sublime Text 3\Packages\ - macOS：
~/Library/Application Support/Sublime Text 3/Packages/ - 可通过
Preferences → Browse Packages…直接打开正确目录
ZIP解压后要重命名：去掉-master、-main等后缀，不能有空格、中文、特殊字符（如BracketHighlighter-master → BracketHighlighter）；若用.sublime-package文件，则不能重命名、不能放子文件夹、必须保持原名。
最常被忽略的是系统时间误差——超过5分钟会导致SSL验证失败，控制台报ssl.CertificateError，先校准时间再折腾其他。
