Package Control加载失败主因是控制台脚本执行中断或文件放错路径；需验证状态栏提示、改用官网动态脚本、将.sublime-package文件放入Installed Packages/目录，并检查ignored_packages配置。
Package Control 加载失败，不是插件没装好，而是它根本没启动成功——90% 的情况是控制台脚本执行卡在 TLS 握手或证书验证，或者手动放错了 Package Control.sublime-package 文件位置。
Package Control 控制台安装失败：别等，先看状态栏和控制台
执行官方 Python 脚本后，只看左下角状态栏是否出现 Package Control: Successfully installed Package Control。如果几秒后只有 reloading plugin 或完全无反应，说明安装中断了。
- 常见原因：
URLError（DNS 或代理不通）、CertificateError（系统 OpenSSL 过旧或企业防火墙拦截 TLS 1.3）、ssl.SSLCertVerificationError（macOS 上尤其多） - 别用旧网页上带
st3或st4字样的脚本——2026 年所有 ST4 稳定版必须用动态生成的https://packagecontrol.io/installation.py脚本 - 执行完别急着关控制台，等满 5 秒再判断；若超时，直接切手动安装，不折腾代理或 hosts
手动安装 Package Control：文件必须进 Installed Packages/，且不能解压
这是最常踩的坑：把 Package Control.sublime-package 丢进 Packages/ 目录，Sublime 会彻底无视它。
- 正确路径：菜单 →
Preferences → Browse Packages…→ 向上退一级 → 进入Installed Packages/目录 - 下载地址必须是官网原始链接：
https://packagecontrol.io/Package%20Control.sublime-package（注意空格是 %20） - 拖入后，删掉该目录下所有含
Package Control字样的旧文件（比如Package Control.sublime-package.bak），避免冲突 - 重启 Sublime 后，按
Ctrl+Shift+P输入Package Control: List Packages——能弹出空列表才算真生效
插件手动安装不生效：先确认路径、命名、ignored_packages 三件事
手动装完插件，命令面板搜不到、菜单不出现，大概率不是代码问题，而是被 Sublime 主动跳过了。
- 路径必须是
Packages/根目录（不是Installed Packages/，也不是Packages/User/子目录） - 文件夹名要干净：比如下载的是
BracketHighlighter-master.zip，解压后重命名为BracketHighlighter，再整个拖进Packages/ - 打开
Preferences → Settings – User，检查"ignored_packages"数组里有没有刚装的插件名（如"BracketHighlighter"），有就删掉 - 重启前务必彻底退出 Sublime（macOS 注意右键 Dock 图标选
Quit，Windows 检查任务栏后台进程）
PyV8 类插件（如 Emmet、CSScomb）报错：不是网络问题，是依赖断链
控制台反复出现 Unable to download package 或 ImportError: No module named PyV8，说明插件依赖的二进制模块缺失，和代理无关。
- Sublime Text 4 已移除 PyV8 支持，升级 ST4 是最干净解法；若必须用 ST3，就得手动补全
- 去 Gitee 镜像站搜
pyv8-win64-p3（Win）、pyv8-macos-universal（macOS）或pyv8-linux-x86_64（Linux） - 解压后，把全部内容（含
__init__.py和pyv8.pyd/pyv8.so）塞进Packages/PyV8/——注意文件夹名必须是PyV8（首字母大写，不能小写或全小写） - 重启后打开控制台观察是否有
reloading plugin PyV8日志，没有则说明路径或大小写错了
真正卡住人的从来不是“怎么装”，而是装完后 Sublime 偷偷忽略你放进去的东西——ignored_packages 配置、大小写敏感的路径、Installed Packages/ 和 Packages/ 的混淆，这三处不核对清楚，重装十次也没用。
