根本原因是网络不可达或channels地址失效；国内用户多因默认域名解析失败、TLS超时或JSON被截断；应修改channels为可用镜像或手动安装插件并正确命名文件夹，再放入对应Packages目录。
“Install Package”空白或提示“No packages available”
这是最典型的症状，控制台可能静默无报错，左下角只显示“Loading…”然后消失。根本原因只有两个：网络不可达，或 channels 地址失效/为空。国内用户几乎全是前者——默认的 https://packagecontrol.io/channel_v3.json 域名解析失败、TLS握手超时、或 JSON 文件被中间设备截断。
- 打开
Preferences > Package Settings > Package Control > Settings – User，检查"channels"是否为空数组或含已失效地址（如过期的 GitHub Gist URL） - 把配置里的
"channels"改成可用镜像，例如：{ "channels": [ "https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" ] } - 保存后重启 Sublime —— 不用等“重载完成”，直接按
Ctrl+Shift+P输入Package Control: Install Package；如果仍卡住，说明该镜像在你当前网络下也不通（Gitee 有时会限流），换另一个镜像或走离线路径
手动安装插件：跳过所有网络环节
关键不是“下载 ZIP”，而是文件夹命名必须和插件官方名完全一致，否则 Sublime 不识别。很多用户解压后保留 EmacsProMode-master 这类名字，结果插件根本不加载。
- 去
https://packagecontrol.io/packages/EmacsProMode页面，找到 “Source” 链接，点进去看仓库地址（通常是 GitHub） - 在 GitHub 页面点击
Code > Download ZIP，解压后得到一个文件夹，比如EmacsProMode-master - 把它重命名为
EmacsProMode（去掉-master，不加任何后缀，大小写敏感） - 复制到你的
Packages目录：
Windows：C:\Users\<username>\AppData\Roaming\Sublime Text 4\Packages\</username>
macOS：~/Library/Application Support/Sublime Text 4/Packages/
Linux：~/.config/sublime-text-4/Packages/
插件装了但功能异常？可能是 Package Control 本体损坏
当换源 + 手动安装都试过，但插件快捷键不响应、设置项不出现，大概率是 Package Control 本体损坏或版本错配——尤其常见于多次手动覆盖、混用 .sublime-package 和同名文件夹的情况。
- 检查
Preferences > Browse Packages打开的目录下，是否存在名为Package Control的文件夹，同时Installed Packages目录里又有Package Control.sublime-package？这是典型冲突，删掉后者即可 - 若仍不稳定，建议彻底重装：官网下载最新
Package Control.sublime-package，放进Installed Packages目录，重启 - ST3 用户注意：某些插件（如 Emmet）依赖已停更的
PyV8，即使插件本身装进Packages，运行时仍会报unable to download PyV8——这不是网络问题，是生态断链，需单独处理或升级到 ST4
离线环境部署：别把插件丢错目录
很多人把下载好的插件 ZIP 文件直接拖进 Installed Packages，以为会自动解压——但 Sublime 只对以 .sublime-package 结尾的 ZIP 文件做自动解压，普通 ZIP 或文件夹必须放对位置。
- 插件为单个文件夹（如
GitGutter）→ 放入Packages目录（不是Installed Packages） - 插件为
xxx.sublime-package文件 → 放入Installed Packages目录 - 若插件有依赖（如
PyV8），它必须是文件夹形式且放在Packages下，不能打包成.sublime-package；内部必须含__init__.py和对应平台的动态库（pyv8.so/pyv8.dylib） - 装完记得检查
Preferences > Settings – User中的"ignored_packages"，别让插件名被意外忽略（如写成"Git gutter"而非"GitGutter"）
最容易被忽略的一点：Sublime 的 Packages 和 Installed Packages 是两套并行机制，混用会导致加载顺序错乱、插件静默失效。离线部署前，先确认你要装的是“可解压插件”还是“已打包插件”，再决定扔进哪个目录——不是所有 ZIP 都能自动解压，也不是所有文件夹都能被识别。
