插件文件须严格区分目录：.sublime-package 文件放 Installed Packages/，ZIP 解压文件夹放 Packages/ 并重命名；路径用控制台命令确认；ignored_packages 会静默禁用插件；PyV8 依赖需匹配系统和 Python 版本并放入 Packages/PyV8/；离线更新需彻底删除旧版再放入新版。
插件文件该放 Installed Packages 还是 Packages？
放错目录是离线安装失败的头号原因，Sublime 不报错，只沉默跳过。你得按文件类型严格区分：
-
.sublime-package文件（如Emmet.sublime-package）→ 必须直接丢进Installed Packages/目录，不解压、不改名、不嵌套 - GitHub 下载 ZIP 解压后得到的文件夹（如
Emmet-master/）→ 必须整体复制进Packages/根目录，且重命名为Emmet（删掉-master，大小写必须和插件官方名完全一致） - 不确定路径？在控制台（
Ctrl+`）运行：print(sublime.installed_packages_path())→ 确认Installed Packages/实际位置print(sublime.packages_path())→ 确认Packages/实际位置
插件放对了却没反应？先查 ignored_packages
命令面板搜不到、快捷键不触发、菜单不出现——不是没装上，而是被 Sublime 主动屏蔽了。这个配置项从不提示，只让插件彻底消失：
- 打开
Preferences → Settings，看右侧用户配置里有没有"ignored_packages"字段 - 如果刚装的插件名（如
"Emmet"、"Origami"）出现在这个列表里，它就被静默禁用 - 删掉对应项，或整行加
//注释，保存后必须完全退出 Sublime（右键任务栏选「退出」，不是关窗口），再重启
老插件报 PyV8 错误？不是网络问题，是依赖缺失
装 Emmet、CSScomb 等老插件时控制台反复报 ImportError: No module named 'PyV8'，这不是代理或证书问题，而是二进制依赖链断了：
- 去 Gitee 镜像站下载对应系统的包（如
pyv8-win64-p3.zip），注意匹配你的系统位数（win64 / win32 / macOS-arm64 / linux-x64）和 Python 版本（p3 表示 Python 3） - 解压后，把所有内容（含
__init__.py和pyv8.pyd或pyv8.so）直接塞进Packages/PyV8/文件夹 - 文件夹名必须是
PyV8（首字母大写，不能小写、不能pyv8），否则 Sublime 找不到
离线更新插件：别覆盖，要清旧再放新
Sublime 会缓存模块导入状态，旧代码可能还驻留在内存里，覆盖同名文件无效：
- 先完全关闭 Sublime Text（检查任务管理器/活动监视器确认无残留进程）
- 进
Packages/目录，删掉整个旧插件文件夹（如ConvertToUTF8/），或删掉旧的.sublime-package文件 - 再把新版本放进去，确保文件夹名 / 文件名完全一致（
Emmet≠emmet≠Emmet-master） - 重启后，打开控制台（
Ctrl+`）观察有无ImportError或AttributeError
