Package Control未生效的三大硬标准：执行Package Control: List Packages无响应、安装后无成功提示、Package Settings中无子菜单；常见原因包括脚本过时、复制出错、旧版残留；网络问题导致安装卡住需科学上网或手动安装；ConvertToUTF8和BracketHighlighter需手动配置关键选项才能生效。
Package Control 没装上，后面所有插件都白装——不是你搜不到插件，是根本没通路。
Package Control 安装失败的三个硬判断标准
别信菜单里有没有“Package Control”选项，只看这三点：
- 按
Ctrl+Shift+P输入Package Control: List Packages，执行后无响应或报错command not found→ 未生效 - 控制台（
Ctrl+`）执行完安装脚本后，左下角没弹出Package Control: Successfully installed Package Control→ 静默失败（常见于网络超时、SSL拦截、脚本被截断） -
Preferences → Package Settings里没有Package Control子菜单 → 框架级缺失，后续所有插件命令都会挂掉
常见坑点：
- ST4 用户误用了 ST3 的旧脚本（比如含
sublime.wbond.net域名），2026 年已全部失效 - 复制脚本时末尾多了空格或换行，Python 解析直接中断，控制台不报错但也不执行
- 已存在旧版
Package Control.sublime-package文件却没清空Installed Packages/目录，新旧版本冲突导致命令通道被劫持
插件卡在 Installing... 的真实原因和绕过方式
Install Package 弹窗空白、转圈超过 10 秒，95% 是网络问题，不是插件源崩了。
Package Control 默认直连 <a href="https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a">https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a</a>，不走系统代理，也不支持配置镜像。它不会提示“网络错误”，只会卡住。
可行解法只有两个：
- 开科学上网（全局模式，确保 Sublime 进程能走）
- 手动安装（适用于离线/受限环境）：
- 访问
<a href="https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a/packages/%E6%8F%92%E4%BB%B6%E5%90%8D">https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a/packages/插件名</a>（如<a href="https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a/packages/Emmet">https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a/packages/Emmet</a>） - 页面右下角点
Download，得到 ZIP 文件 - 解压后把整个文件夹（不是 ZIP 包本身）拖进
Preferences → Browse Packages…打开的目录 - 文件夹名必须和插件名完全一致、大小写敏感（
ConvertToUTF8≠converttoutf8）
- 访问
注意：手动安装的插件不会出现在 List Packages 结果里，也无法用 Remove Package 卸载，得进 Packages/ 目录手动删文件夹。
ConvertToUTF8 和 BracketHighlighter 配置不生效的典型漏项
这两个插件装完常被误判为“没起作用”，其实只是关键配置项没开：
ConvertToUTF8：
- 它只负责打开时自动转码，不影响保存行为
- 如果你希望文件默认以 UTF-8 保存，必须额外操作：
-
File → Save with Encoding → UTF-8（一次设置，当前文件生效） - 或在用户设置里加：
"default_encoding": "UTF-8"（影响新建文件）
-
BracketHighlighter：
- 默认只高亮括号本身，不显示竖线范围标识
- 必须在插件设置中显式开启：
"content_highlight_bar": true - 这个选项不在默认配置里，不手写就不会有；漏掉后看起来就像没装
两者都依赖 Package Control 正常加载，如果插件设置菜单里压根找不到它们的 Settings 项，先回去检查框架是否真装上了。
真正卡住人的从来不是“怎么点菜单”，而是装完 Package Control 后没验证它是否可执行命令，以及插件装完后没意识到多数功能要靠手动补配置才能可见。网络不通时等 3 分钟刷新不如直接切手动路径，而大小写、路径层级、配置开关这些细节，错一个就等于没装。
