Package Control控制台安装失败，先确认是否真没装上：命令面板搜不到Install Package说明未加载；运行sublime.version()查版本，ST4需用带sha256校验的新脚本，旧脚本会静默失败；删净Installed Packages/中旧Package Control文件后重装；.sublime-package必须放Installed Packages/，解压文件夹必须整体放Packages/根目录；ignored_packages列表屏蔽插件需手动移除并重启。
Package Control 控制台安装失败，先确认是否真没装上
命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）里搜不到 Package Control: Install Package，基本等于它根本没加载。别急着重装，先打开控制台（Ctrl+`），输入 sublime.version() 看输出——如果返回的是 4xxx，你用的是 Sublime Text 4，旧版安装脚本会静默失败；如果是 3xxx，再检查网络或证书问题。
常见假成功现象：Package Control installed 提示出现，但后续命令面板仍无响应。这通常是残留的旧版 Package Control.sublime-package 文件劫持了命令通道。进 Installed Packages/ 目录，删掉所有含 Package Control 字样的文件，再重跑最新安装脚本（必须带 hashlib.sha256 校验）。
.sublime-package 文件该扔进 Installed Packages 还是 Packages？
放错路径是手动安装失效的第一原因，Sublime 对这两个目录有硬性分工：
-
.sublime-package文件（如Emmet.sublime-package）→ 必须直接丢进Installed Packages/，不要解压，重启即生效 - GitHub 下载的 ZIP 解压后得到的文件夹（如
Emmet/）→ 必须整体复制进Packages/根目录，不能嵌套在子文件夹里，也不能改名成Emmet-master/
用 Preferences → Browse Packages… 打开的路径就是 Packages/；它的上一级目录里的 Installed Packages/ 才是另一个位置。混淆这两者，插件永远不会被加载。
插件放对了却没反应？优先查 ignored_packages
插件文件夹明明在 Packages/ 里，命令面板搜不到、快捷键不触发、菜单不出现——八成是被 Sublime 主动忽略了。打开 Preferences → Settings，看右侧用户配置中是否有 "ignored_packages" 字段：
- 常见值如
["Vintage", "Anaconda"]，如果你刚放进去的插件叫EmmyLua，而它也在这个列表里，就会被静默屏蔽 - 删掉对应项，或整行注释掉，保存后必须重启 Sublime 才生效
- 某些插件（如
Origami）还依赖命令面板里手动执行一次初始化命令，不是放进去就自动弹窗
PyV8 报错不是网络问题，是依赖链断了
装 Emmet、CSScomb 等老插件时，控制台反复报 ImportError: No module named 'PyV8' 或卡在 Unable to download package，这不是代理或 DNS 的锅，而是官方源已归档，Package Control 找不到有效地址。
ST4 用户请直接升级，PyV8 已被彻底移除；若必须用 ST3：
- 去 Gitee 镜像站下载对应系统的包，例如
pyv8-win64-p3.zip（Win64 + Python 3） - 解压后把全部内容（含
__init__.py和pyv8.pyd或pyv8.so）塞进Packages/PyV8/文件夹 - 注意：文件夹名必须严格为
PyV8（首字母大写），小写会导致ImportError
离线更新插件时，覆盖同名文件基本无效——Sublime 会缓存模块状态。必须先关掉 Sublime，删掉旧插件文件夹或 .sublime-package，再放新版本，重启后打开控制台观察 reloading plugin 日志，确认加载的是新版。
