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 默认直连 @#@#@#@#@#@#@#@#@#@0,不走系统代理,也不支持配置镜像。它不会提示“网络错误”,只会卡住。
可行解法只有两个:
- 开科学上网(全局模式,确保 Sublime 进程能走)
- 手动安装(适用于离线/受限环境):
- 访问
@#@#@#@#@#@#@#@#@#@1(如@#@#@#@#@#@#@#@#@#@2) - 页面右下角点
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 分钟刷新不如直接切手动路径,而大小写、路径层级、配置开关这些细节,错一个就等于没装。











