Package Control 安装后 Install Package 无反应或列表为空，本质是网络通道未通；需先验证能否成功获取插件列表（左下角显示 Fetching list），再排查 DNS、代理、channels 配置、缓存同步及作用域匹配等问题。
Package Control 装好了，但 Install Package 命令没反应、卡住、或列表为空——这不是插件没装上，而是通道没通。必须先确认它真能联网拉取元数据，再谈装插件。
按 Ctrl+Shift+P 后搜不到 Install Package？先验通道是否活着
菜单里有 Package Control 项 ≠ 功能可用。真正有效的验证方式只有一种：Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）呼出命令面板，输入 Package Control: Install Package，观察左下角是否出现 Fetching list of available packages。
- 如果直接报错、闪退、或输入后无任何反馈：大概率是
Package Control核心未加载成功，需重装（删掉Installed Packages/下所有含Package Control字样的文件，再执行最新脚本） - 如果卡在
Fetching...超过 15 秒：不是插件源慢，而是 DNS 污染或 TLS 握手失败。换手机热点最有效；企业网用户需手动配置"http_proxy"和"https_proxy"到Package Control.sublime-settings用户配置中 - 如果提示
There are no packages available：检查Preferences → Package Settings → Package Control → Settings – User中的"channels"是否为默认值"https://packagecontrol.io/channel_v3.json"，拼错、写成http或多加斜杠都会静默失败
Install Package 执行后列表空白或加载极慢？别等，先同步源
Package Control 首次运行不会立刻拉全量插件列表，它分两步：先载 channel 文件，再并发请求每个插件的 metadata。任一环节超时，UI 就卡住不报错。
- 手动触发
Package Control: Synchronize Packages，比重启 Sublime 更快刷新本地缓存 - 如果仍失败，进
Cache/Package Control/目录（可通过Preferences → Browse Packages…上级路径找到），删掉整个Package Control/文件夹再试 - macOS 用户注意：
~/Library/Caches/Sublime Text 4/Cache/Package Control/是真实路径，Finder 默认隐藏，需按Cmd + Shift + .显示
插件名输对了却搜不到？检查作用域和忽略列表
插件安装成功 ≠ 立即生效。Sublime 的激活逻辑高度依赖当前文件类型和配置状态。
- 右下角状态栏看当前语法是否匹配插件支持的作用域（例如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域；打开纯.html文件时它完全静默） - 按
Ctrl+Shift+P输入Set Syntax: Vue强制切换语法，再测试高亮是否出现 - 打开
Preferences → Settings，右侧用户配置里检查是否有"ignored_packages": [...]，刚装的插件名若在里面，就会被直接屏蔽（比如误写了"Emmet"却忘了删） - 路径错误也常见：下载的是
Emmet.sublime-package→ 必须放Installed Packages/；下载的是 ZIP 解压出的Emmet/文件夹 → 必须整体拖进Packages/（不是子目录！）
手动安装插件时，.sublime-package 和源码 ZIP 怎么选？
两者加载机制不同，不能混用。
-
.sublime-package是 zip 打包的二进制格式，Sublime 启动时自动解压到内存，适合日常使用：下载后直接丢进Installed Packages/，重启即用，更新只需替换文件 - 源码 ZIP 是开发态，解压后是完整文件夹（如
Packages/Emmet/），可直接改 Python 文件调试，但需确保文件夹名与插件名严格一致（大小写敏感），且不能和同名.sublime-package共存，否则后者优先级更高 - 如果你不确定，优先选
.sublime-package；只有需要 patch 行为或排查插件内部逻辑时，才用源码 ZIP
Package Control 在后台静默失败的网络握手、作用域匹配的隐式规则、以及路径大小写这种肉眼难辨的细节。装完别急着搜插件，先让 Fetching list of available packages 真正跑起来。 
