package control未真正就绪是插件安装失败主因，验证标准唯二：ctrl+shift+p执行list packages能返回（哪怕空列表），且install package后状态栏显示fetching list；st4必须用官网installation.py脚本，执行后等5秒见“successfully installed”提示才算成功。
装不上插件，八成不是插件问题，而是 Package Control 根本没通路——菜单里有选项、命令面板能搜到名字，都不代表它真能联网加载列表。
Ctrl+Shift+P 输入 Install Package 没反应？先验证 Package Control 是否真正就绪
别信“菜单出现”或“控制台没报错”，只认两个硬指标：
-
Package Control: List Packages能执行并返回（哪怕空列表） -
Package Control: Install Package执行后状态栏出现Loading packages或Fetching list of available packages - 若卡在命令面板关闭、控制台静默、左下角无任何提示，大概率是旧版残留劫持了命令通道——去
Installed Packages/目录删掉所有含Package Control字样的文件再重试
ST4 用户粘贴脚本后显示 “Success!” 却无法安装插件？版本和哈希值对不上
Sublime Text 4 必须用官网当前有效的 installation.py 脚本，旧版 ST3 脚本（哈希值以 6f4c264a 开头）在 ST4 上会静默失效：控制台显示成功，但 Install Package 命令不触发网络请求。
- 正确做法：按
Ctrl+`呼出控制台，一次性粘贴并执行官方最新脚本：import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 执行后必须等满 5 秒，看左下角是否弹出
Package Control: Successfully installed Package Control - 若只显示
reloading plugin就停住，基本是 TLS 握手失败或 DNS 污染，换手机热点重试最有效
插件列表一直卡在 “Fetching…”？packagecontrol.io 不支持代理和镜像
这不是插件源挂了，是 Sublime 的 Package Control 本身不读取系统代理、也不支持配置镜像地址。国内直连 https://packagecontrol.io 失败时，没有折中方案。
- 唯一可靠解法：科学上网（全局模式，非仅浏览器）
- 临时替代：手动下载插件 ZIP 包，解压后整体拖进
Packages/目录（注意不是Installed Packages/），文件夹名必须与插件名完全一致且大小写敏感（如ConvertToUTF8写成converttoutf8就不生效） - 验证连通性可在控制台执行：
urllib.request.urlopen('https://packagecontrol.io/').getcode()，返回200才算通
插件装完却不工作？语法作用域和路径放错是高频原因
插件不是放进目录就自动运行，它依赖当前文件的语法标识（scope）和加载路径是否合规。
- 右下角状态栏看当前语法：比如
Vue Syntax Highlight只在.vue文件或作用域为text.html.vue时生效，纯.html文件不会触发 - 路径必须严格：插件包
Emmet.sublime-package→ 放入Installed Packages/；解压后的Emmet/文件夹 → 整体拖入Packages/（不能套在子目录里） - 检查用户设置里
"ignored_packages"数组是否误写了插件名（如"Emmet"），会导致插件被主动禁用
最常被忽略的是：插件配置项（比如 BracketHighlighter 的 "content_highlight_bar": true）不写进设置文件，它就只是个摆设；而 ConvertToUTF8 仅解决打开乱码，保存编码仍需手动选 File → Save with Encoding → UTF-8。
