插件应按格式分放Packages或Installed Packages:.sublime-package文件直接放入Installed Packages;解压后的文件夹(如Emmet)整体放入Packages顶层。若不生效,检查ignored_packages配置并清除对应项;PyV8依赖失败需手动补全二进制文件至Packages/PyV8/;离线更新须先删除旧版再放入新版并重启验证。

插件文件该放 Packages 还是 Installed Packages?
放错目录是离线安装失败最常见原因。Sublime Text 严格区分两类路径:Packages 用于存放解压后的插件文件夹,Installed Packages 只接收未解压的 .sublime-package 文件。
- 如果你下载的是
Emmet.sublime-package—— 直接扔进Installed Packages,别解压,重启即生效 - 如果你下载的是
Emmet-master.zip—— 解压后得到一个叫Emmet的文件夹(注意大小写),整个文件夹复制进Packages,不是子目录,就是顶层 - 用
Preferences → Browse Packages…打开的路径,就是Packages;它的上一级里的Installed Packages才是另一个位置
为什么插件放对了还是不生效?检查 ignored_packages
插件明明在 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日志,确认加载的是新版本
最麻烦的永远不是“怎么放”,而是“放完谁在用它”——ST3 的 Python 运行时、插件自身的初始化逻辑、还有 Package Control 残留的元数据,都可能让一次看似正确的手动安装变成静默失效。动手前先看一眼控制台,比反复重启更省时间。

















