插件安装失败主因是路径错误或ignored_packages拦截：.sublime-package文件放installed packages，源码文件夹放packages顶层；被忽略需检查并修改ignored_packages配置；pyv8报错需手动补依赖；更新插件须彻底删除旧版再放入新版并重启。
手动安装插件失败，90% 是因为路径放错或 ignored_packages 拦截了——不是代码问题，是 Sublime 的目录规则和配置机制在起作用。
插件文件该扔进 Packages 还是 Installed Packages？
Sublime Text 严格区分两类目录，放错就等于没装：
- 如果下载的是
Emmet.sublime-package（带 .sublime-package 后缀的单个文件）→ 直接丢进Installed Packages目录，不要解压，重启即生效 - 如果下载的是
Emmet-master.zip或 GitHub 源码 → 解压后得到一个叫Emmet的文件夹（注意大小写）→ 整个文件夹复制进Packages目录顶层，不能嵌套在子文件夹里 - 用
Preferences → Browse Packages…打开的路径就是Packages；它的上一级目录里的Installed Packages才是另一个位置
插件放对了却没反应？先查 ignored_packages
命令面板搜不到、快捷键不触发、菜单不出现——大概率被 Sublime 主动忽略了。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 常见值如
["Vintage", "Anaconda"]，如果刚放进去的插件名（比如"Emmet"）也在这个列表里，它就被静默禁用了 - 删掉对应项，或临时注释整行，保存后重启再验证
PyV8 报错不是网络问题，是依赖链断了
装 Emmet、CSScomb 等老插件时卡在 Unable to download package，控制台反复报 PyV8 错误？这不是代理没配好，而是官方源已归档，Package Control 根本找不到有效地址。
- Sublime Text 4 已彻底移除 PyV8，升级是最干净解法；若必须用 ST3，就得手动补二进制依赖
- 去 Gitee 镜像站下载对应系统的包，例如
pyv8-win64-p3.zip（Win64 + Python 3） - 解压后，把所有内容（含
__init__.py和pyv8.pyd或pyv8.so）直接塞进Packages/PyV8/文件夹——注意：文件夹名必须是PyV8（首字母大写），不能小写
离线更新插件：删旧 ≠ 覆盖，要清空再重放
Sublime 会缓存模块导入状态，旧代码可能还驻留在内存里，覆盖同名文件基本无效。
- 先关闭 Sublime Text
- 进
Packages目录，删掉整个旧插件文件夹（如ConvertToUTF8）或旧的.sublime-package文件 - 再把新版本放进去，确保文件夹名 / 文件名完全一致（大小写敏感）
- 重启后，建议打开控制台（
Ctrl+`）观察有无ImportError或reloading plugin日志，确认加载的是新版
最易被忽略的是：插件配置永远只改 Packages/User/插件名.sublime-settings，别碰插件自带的 settings 文件——一升级就全被覆盖。另外，ST 不自动重载 Python 插件模块，更新后不重启，很多行为根本不会变。
