package control安装失败主因是脚本未执行、校验值失效或路径错误；mac用户需将package control.sublime-package文件严格拖入~/library/application support/sublime text 3/installed packages/目录，不改名不解压，重启后验证命令是否出现。
Package Control 安装失败的常见原因
插件装不上，90% 是因为 Package Control 没装成功，而不是网络或权限问题。Mac 上最常卡在三个环节：控制台粘贴脚本后没回车、脚本过期（SHA256 校验值失效）、或 Installed Packages 目录路径写错。
当前（2026 年）有效的手动安装方式是直接下载 Package Control.sublime-package 文件，拖进 ~/Library/Application Support/Sublime Text 3/Installed Packages/，不改名、不解压、不重启前别点开命令面板。
- 用
Command + Shift + P输入Browse Packages可快速定位到Packages目录，但注意：它和Installed Packages不是同一个文件夹 - 隐藏目录必须用
Command + Shift + .才能看见，否则访达里找不到Application Support - 如果拖进去后重启仍无
Package Control: Install Package命令，说明文件名不是严格等于Package Control.sublime-package（大小写、空格、扩展名都必须一致）
用 Command + Shift + P 安装插件时没反应
不是插件源挂了，而是 Package Control 的 channel 文件没加载成功。此时 Install Package 命令会消失，或输入后只显示“Loading…”然后空白。
解决办法不是重装，而是强制刷新 channel：
- 打开控制台（
Command + `），输入sublime.log_commands(True)回车，再试一次Command + Shift + P→Install Package，看控制台是否输出错误（比如URLError或ssl.SSLCertVerificationError） - 若提示证书错误，说明系统时间不准或 Python SSL 配置异常，临时方案是改用手动安装：去 packagecontrol.io 找插件页，下载
.sublime-package文件，同样拖进Installed Packages目录 - 部分插件（如
ChineseLocalization）不走 Package Control，必须手动下载.sublime-package文件并拖入，且需重启才生效
subl 命令可用但插件无法启动
终端能运行 subl，不代表插件环境就绪。Sublime 启动时会加载两个独立路径：Packages/（用户插件）和 Installed Packages/（已启用插件包），后者缺一不可。
典型现象：Emmet 插件装完后缩写不展开、快捷键无效。检查步骤：
- 确认插件确实出现在
Command + Shift + P→Package Control: List Packages列表中（没出现=没激活） - 打开
Preferences → Package Settings，看对应插件菜单是否存在；不存在说明插件未完成初始化，可能是依赖缺失（如 Emmet 依赖PyV8，但新版 Sublime 已弃用，应换用官方维护的Emmet 2） - 某些插件（如
SideBarEnhancements）需要右键菜单触发，不能仅靠快捷键测试
插件安装后功能异常或崩溃
不是插件本身坏了，而是和当前 Sublime 版本或其它插件冲突。尤其注意 Apple Silicon（M1/M2/M3）机型上，部分老插件仍依赖 x86_64 架构的 Python 组件。
排查优先级：
- 禁用所有插件（
Preferences → Package Control → Disable Package），逐个启用，定位冲突源 - 查看控制台输出（
Command + `）是否有ImportError或AttributeError: 'NoneType' object has no attribute 'xxx'类错误 - 插件作者若已停止维护（如多数 ST3 早期插件），建议换用替代品：例如用
BracketHighlighter替代已停更的Brackets，用Sync Settings替代Settings Sync
最易被忽略的一点：Sublime Text 3 和 Sublime Text 4 的插件兼容性不完全互通，尤其是涉及 API 调用（如 view.substr() 返回类型变更）。装插件前先确认它标明支持的 ST 版本号。
