插件安装失败主因是package control未加载或插件路径错误；需先确认install package命令是否存在，再检查st版本匹配脚本、清除残留文件、正确放置.sublime-package至installed packages/或解压文件夹至packages/根目录，并排查ignored_packages屏蔽。
插件安装失败，90% 不是网络问题，而是 Package Control 没真正加载，或插件文件放错了目录。
Package Control: Install Package 命令不出现
这不是插件装不上，是包管理器根本没跑起来。先别折腾插件，确认 Package Control 本身是否就位：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control，看有没有Package Control: Install Package这一行 - 没有？打开控制台（
Ctrl+`），运行sublime.version()：返回4xxx表示 ST4，必须用带hashlib.sha256校验的新脚本；返回3xxx则旧脚本可能仍可用 - 进
Installed Packages/目录，删掉所有含Package Control字样的文件（包括残留的Package Control.sublime-package），再从packagecontrol.io/installation复制最新脚本执行 - 执行后必须完全退出 Sublime（右键任务栏选「退出」，不是关窗口），再重启验证
.sublime-package 文件该放 Installed Packages 还是 Packages？
放错路径是手动安装失效的第一原因，Sublime 对这两个目录有硬性分工：
-
.sublime-package文件（如EmmyLua.sublime-package）→ 必须直接丢进Installed Packages/，不要解压，重启即生效 - GitHub 下载的 ZIP 解压后得到的文件夹（如
Emmet/）→ 必须整体复制进Packages/根目录，不能嵌套、不能改名（比如不能叫Emmet-master/） - 用
Preferences → Browse Packages…打开的路径就是Packages/；它的上一级目录里的Installed Packages/才是另一个位置 - 不确定路径？在控制台运行
print(sublime.installed_packages_path())和print(sublime.packages_path())查真实路径
插件放对了却没反应？优先查 ignored_packages
插件文件夹明明在 Packages/ 里，命令面板搜不到、快捷键不触发、菜单不出现——八成是被 Sublime 主动忽略了：
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 常见值如
["Vintage", "Anaconda"]，如果你刚放进去的插件叫Emmet，而它也在这个列表里，就会被静默屏蔽 - 删掉对应项，或整行注释掉，保存后必须重启 Sublime 才生效
- 某些插件（如
Origami）还依赖命令面板里手动执行一次初始化命令，不是放进去就自动弹窗
PyV8 类依赖失败不是网络问题，是生态断链
装 Emmet、CSScomb 等老插件时卡在 Unable to download package，控制台反复报 PyV8 错误？这不是你代理没配好，而是官方源已归档：
- Sublime Text 4 已彻底移除
PyV8，升级是最干净解法 - 若必须用 ST3，去 Gitee 镜像站下载对应系统的包，例如
pyv8-win64-p3.zip（Win64 + Python 3） - 解压后，把所有内容（含
__init__.py和pyv8.pyd或pyv8.so）直接塞进Packages/PyV8/文件夹——注意：文件夹名必须是PyV8（首字母大写，大小写敏感） - 别用 ZIP 文件夹结构，也别放
Installed Packages/；PyV8必须是文件夹形式，且路径为Packages/PyV8/
最容易被忽略的是：手动安装不是“丢进去就完事”，而是每一步都必须严格匹配路径、命名、大小写和重启时机。尤其是 ignored_packages 屏蔽和 PyV8 的文件夹命名，错一个字符，插件就永远不加载。
