package control显示“unable to download package list”表明sublime text无法访问其服务器，主因是网络连接问题（代理、防火墙、dns污染或github raw链接不稳定），需先测试浏览器能否打开https://packagecontrol.io/channel_v3.json，再配置国内镜像源或修复ssl证书验证失败问题。
Package Control安装后显示“Unable to download package list”
这是最典型的症状，说明Sublime Text根本没连上Package Control的服务器。不是插件本身有问题，而是Package Control在启动时尝试拉取channel_v3.json失败，后续所有插件搜索、安装都会卡住或报错。
常见诱因是系统代理、防火墙、DNS污染，或国内网络对GitHub Raw链接（如https://packagecontrol.io/channel_v3.json）的不稳定访问。别急着重装Sublime或删配置，先确认是否真连不上：
- 在浏览器中直接打开
https://packagecontrol.io/channel_v3.json—— 如果打不开或超时，问题就在这儿 - 如果能打开，但Sublime里仍报错，检查是否启用了系统级代理（比如Clash、Surge的全局模式未生效到Sublime进程）
- Mac用户注意：Sublime默认不继承Shell的
http_proxy环境变量，GUI应用走的是独立网络栈
手动配置Package Control使用国内镜像源
官方源不可靠时，换用可信镜像最有效。目前较稳定的有清华、中科大、腾讯云COS托管的channel文件，只需改一行配置。
操作路径：Preferences → Package Settings → Package Control → Settings – User，在右侧JSON中添加或修改channels字段：
{
"channels": [
"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json"
]
}
注意点：
- 必须是完整URL，结尾带
/channel_v3.json，不能只写域名 - 不要保留默认的
https://packagecontrol.io/channel_v3.json，避免 fallback 失败拖慢响应 - 改完保存后，重启Sublime或按
Ctrl+Shift+P（Win/Linux）/Cmd+Shift+P（Mac）执行Package Control: Satisfy Dependencies触发重载
证书验证失败导致HTTPS连接中断（macOS / Python 3.8+）
Sublime Text 4 内置Python 3.8+，部分系统（尤其是macOS新版本）缺少根证书或证书链不全，会导致ssl.SSLCertVerificationError，错误信息里常含certificate verify failed。
这不是网络问题，是Sublime内部SSL校验失败。临时绕过（仅限调试）可加参数启动：
- macOS终端执行：
subl --ignore-certificate-errors - Windows PowerShell：
& "C:\Program Files\Sublime Text\subl.exe" --ignore-certificate-errors
但更稳妥的做法是更新系统证书或让Sublime信任系统钥匙串：
- macOS：运行
/Applications/Sublime Text.app/Contents/MacOS/sublime_text --update-ssl-certificates（需Sublime Text 4094+） - 或者手动把
/etc/ssl/cert.pem（Linux/macOS）或系统CA证书路径填进Package Control设置里的ssl_certificate字段
插件安装后不生效或命令面板搜不到
成功安装≠自动启用。很多插件（比如EmmyLua、JsPrettier）依赖额外二进制工具（lua、prettier），或需要手动启用语法高亮/构建系统。
排查步骤：
- 打开
Console（Ctrl+`），看是否有ImportError或command not found报错 - 检查插件目录：
Data/Packages/插件名/是否存在，且含.py主文件 - 某些插件要求重启Sublime才加载，特别是修改了
Default.sublime-settings的 - 插件命令是否绑定快捷键？没绑定的话只能通过
Ctrl+Shift+P输入命令名调用
真正麻烦的从来不是“装不上”，而是“装上了却不知道它要什么”。比如SublimeLinter系列，不配好linter可执行路径，它就安静得像没装过。
