需手动启用命令日志：输入 sublime.log_commands(true) 后重试安装，才能看到 http 状态、路径、权限等真实错误；排查后立即关闭日志避免干扰。
怎么打开插件安装的底层日志
Sublime 默认不记录 Package Control 安装插件时的网络请求、解压路径或权限错误，光看控制台（Ctrl + `）往往一片空白——这不是没输出，是根本没开日志开关。
必须手动启用命令级日志才能看到真实动作：
- 打开控制台（
Ctrl + `），输入并回车：sublime.log_commands(True) - 再执行一次
Package Control: Install Package，观察控制台里出现的command: package_control_install_package及其后续的 HTTP 状态、临时目录路径、Permission denied或zipfile.BadZipFile等线索 - 排查完立刻关掉：
sublime.log_commands(False)，否则日志会持续刷屏干扰日常操作
为什么 List Packages 里找不到刚放进去的插件
不是插件没装上，而是 Sublime 没“认出来”——它只加载符合命名规范、无冲突、有合法结构的文件夹。
常见卡点：
- 插件文件夹名含空格或版本后缀，比如
BracketHighlighter v2→ 必须重命名为BracketHighlighter - 大小写不一致：macOS/Linux 对大小写敏感，
emmet和Emmet是两个不同目录，只有后者能被识别 -
.sublime-package和同名文件夹共存：Sublime 优先加载压缩包，会忽略你手动放进Packages/的文件夹，删掉Installed Packages/Emmet.sublime-package再试 - 文件夹里缺
.py主文件或package-metadata.json，部分新插件要求后者才显示在列表中
怎样确认插件物理存在但未生效
绕过 Package Control，直查磁盘——这是最硬核也最可靠的验证方式。
菜单栏点击 Preferences → Browse Packages…，你会看到一个纯文件管理器窗口，里面每个子文件夹就是一个“已安装”的插件实体：
- Windows 路径通常是：
%APPDATA%\Sublime Text\Packages\ - macOS 路径是：
~/Library/Application Support/Sublime Text\Packages/ - Linux 路径是：
~/.config/sublime-text\Packages/ - 如果这里能看到插件文件夹，但
Package Control: List Packages不显示，基本可断定是命名、大小写或结构问题；如果这里也没有，说明根本没放对位置
安装失败时控制台为什么还是空的
因为默认日志级别太低，连 HTTP 请求都过滤掉了。很多失败发生在网络层（如证书校验失败、代理超时）或解压阶段（如 zip 损坏、磁盘满），这些不会触发 Python 异常，也就不会自动打印 traceback。
真正有用的调试组合是：
- 先开命令日志：
sublime.log_commands(True) - 再配合系统级抓包（如用
tcpdump或 Wireshark 抓packagecontrol.io的 HTTPS 流量）验证是否发出了请求 - 检查
~/.config/sublime-text/Cache/Package Control/（Linux/macOS）或对应 Windows 缓存目录下有没有残留的临时.tmp文件，它们可能泄露下载中断的位置
最常被忽略的一点：日志开了但没重试安装——必须在开启日志后重新触发一次 Install Package，否则什么都不会输出。
