.sublime-package文件必须放入Installed Packages/目录，解压后的插件文件夹须整体放入Packages/根目录；路径错误、ignored_packages屏蔽、进程未彻底重启或依赖不兼容均会导致安装失败。
插件文件扔进哪个目录才算对
Sublime Text 严格区分 Packages 和 Installed Packages，放错就等于没装，控制台甚至不报错——它直接跳过加载。
-
.sublime-package文件（如Emmet.sublime-package）必须放进Installed Packages/目录，不能解压、不能改名、不能嵌套子目录 - 从 GitHub 下载的 ZIP 解压后得到的文件夹（如
Emmet-master/），必须整体复制进Packages/根目录，且重命名为规范名（如Emmet），去掉-master、空格、中文、点号 - 不确定路径？在控制台运行
print(sublime.packages_path())和print(sublime.installed_packages_path())，输出的就是真实路径 - 别信“拖进 Sublime 窗口”这种操作——它默认往
Packages/里扔，但你拖的是.sublime-package文件，结果就是白忙活
ignored_packages 是静默失效的元凶
插件文件放对了、重启也做了，命令面板却搜不到任何相关命令？大概率被 ignored_packages 拦截了——Sublime 启动时发现签名异常或结构不全，会自动把它加进黑名单，不加载也不提示。
- 在控制台输入
sublime.load_settings('Preferences.sublime-settings').get('ignored_packages')，回车查看当前被忽略的插件列表 - 打开
Preferences → Settings – User，检查右侧 JSON 中是否存在"ignored_packages"字段 - 如果刚手动放进去的插件名（如
"SideBarEnhancements"）出现在该数组里，删掉对应项，保存后必须彻底退出 Sublime 再重启 - 别只关窗口：Windows 要在任务管理器结束所有
subl.exe进程；macOS 右键 Dock 图标选Quit；Linux 执行pkill -f "subl"
重启不彻底 = 白装
Sublime 的插件模块常驻内存，仅关闭窗口不会卸载已加载的 Python 模块。旧版本残留会干扰新文件加载，导致“明明放了却没反应”。
- 关掉所有窗口后，务必确认进程已终止——否则
Packages/下新增的文件夹根本不会被扫描 - 重启后验证方式很直接：按
Ctrl+Shift+P输入插件名关键词，看是否出现对应命令（如Emmet: Expand Abbreviation） - 若仍无响应，打开控制台观察是否有
reloading plugin XXX failed或ImportError日志，第一行File "./Packages/XXX/...就是问题插件名 - 遇到
ImportError: No module named 'some_missing_dep'？说明插件依赖其他模块（如sublime_lib），得把依赖也以.sublime-package形式放进Installed Packages/
PyV8 报错不是网络问题，是 ST4 兼容断层
装老插件（如 Emmet、CSScomb）时控制台反复刷 PyV8 错误，不是代理没配好，而是 Sublime Text 4 已移除 PyV8 支持——官方源归档后 Package Control 根本找不到适配地址。
- 最干净解法是升级插件本身，或换用 ST4 原生兼容版本（如
Emmet 2） - 若必须用旧版，需手动补二进制依赖：去 Gitee 镜像站下载对应系统包（如
pyv8-win64-p3.zip），解压后把全部内容塞进Packages/PyV8/（注意文件夹名必须是PyV8，首字母大写） - 别把
PyV8放进Installed Packages/——它必须是源码形式，且路径和命名大小写敏感 - 补完后重启，控制台应不再报
Unable to download package或PyV8 not found
