Sublime Text 插件安装失败多因路径、代理、缓存或配置问题，70% 功能异常源于安装细节偏差；应查控制台报错、改用本地安装、指定本地 channel 文件、检查 ignored_packages 及解压结构。
Sublime Text 插件安装不是“点几下就完事”的操作，很多卡顿、失败、功能不生效的问题，根源都在安装路径、网络代理、缓存机制或配置层级上。直接用 Package Control 搜索安装看似简单，但实际中超过 70% 的插件问题（比如 Emmet 不触发、BracketHighlighter 不高亮、AutoFileName 不提示路径）都出在安装环节的细节偏差。
Package Control 安装失败时别硬等，先查控制台报错
执行安装命令后如果没反应或报错，Ctrl+` 打开控制台是第一动作。常见错误包括：
-
urlopen error [Errno 11001] getaddrinfo failed：DNS 或代理问题，不是网络慢，而是根本连不上packagecontrol.io -
UnicodeDecodeError: 'utf-8' codec can't decode byte：Windows 下路径含中文或特殊字符，导致sublime.installed_packages_path()返回乱码路径 -
PermissionError: [WinError 5] 拒绝访问：Sublime 被以普通用户启动，但Installed Packages目录在 Program Files 下需要管理员权限
解决办法不是重试，而是改用本地安装：Preferences → Browse Packages… 进入父目录，手动创建 Installed Packages 文件夹（若不存在），再把下载好的 Package Control.sublime-package 文件拖进去，重启即可。
Install Package 卡在“Loading…”本质是 channel_v3.json 下载失败
这个 JSON 文件约 4MB，每次打开命令面板都会尝试拉取最新版。国内直连基本超时，表现为输入 Install Package 后长时间停在加载状态。
绕过方法是手动指定本地 channel 文件：
- 从
https://packagecontrol.io/channel_v3.json下载文件（推荐用 IDM 或浏览器另存） - 保存到任意本地路径，例如
D:\sublime\channel_v3.json - 打开
Preferences → Package Settings → Package Control → Settings – User - 写入：
"channels": ["D:/sublime/channel_v3.json"]（注意 Windows 路径用正斜杠或双反斜杠）
改完保存，再调 Ctrl+Shift+P → Install Package 就会秒响应。别信“多等一会儿”，这是确定性失败。
Emmet、SideBarEnhancements 等插件安装后不生效？检查是否被 ignored_packages 屏蔽
很多用户装完插件发现快捷键没反应、右键菜单没新增项，其实插件已安装成功，只是被全局禁用了。
打开 Preferences → Settings，看右侧用户设置里是否有：
"ignored_packages": [
"Emmet",
"SideBarEnhancements"
]
如果有，删掉对应条目；如果没有，检查是否在 Package Control.sublime-settings 里误加了屏蔽项。另外，某些主题插件（如 Material Theme）会自带配套插件包，如果重复安装同名插件，Sublime 会自动 ignore 后装的那个。
手动安装插件时，解压位置必须严格匹配插件结构
比如下载的是 BracketHighlighter.zip，不能直接解压进 Packages/ 目录——要确认 ZIP 内顶层目录名是否为 BracketHighlighter。如果是 bracket-highlighter-master/BracketHighlighter/ 这种结构，只把里面的 BracketHighlighter 文件夹拖进 Packages/，而不是整个 bracket-highlighter-master。
验证方式：重启 Sublime 后，在 Preferences → Package Settings 菜单里能看到对应插件条目，才算真正加载成功。光有文件夹 ≠ 插件启用。
最常被忽略的一点是：Sublime 的插件加载顺序依赖文件夹名和 .sublime-package 文件的哈希校验。哪怕只是多一个空格、大小写不符、或 ZIP 解压时保留了 macOS 的 __MACOSX 隐藏目录，都会导致插件静默失效——它不会报错，也不会出现在菜单里，你只会觉得“怎么装了没用”。
