不能直接双击安装.sublime-package文件，因为系统会用归档工具解压而非交由Sublime加载，导致文件错放；正确做法是将.sublime-package文件放入Installed Packages/目录，或将解压后的插件文件夹整体放入Packages/根目录，并确保命名规范、路径准确、重启验证。
为什么不能直接双击安装 .sublime-package 文件
双击打开 .sublime-package 文件，系统会尝试用默认程序（通常是归档工具）解压它，而不是交给 Sublime 加载——这会导致文件被错误解包到桌面或 Downloads 目录，Sublime 根本看不到。真正有效的安装路径只有两条：Installed Packages/ 目录下放二进制包，或 Packages/ 目录下放源码文件夹。
手动安装未审核插件的正确路径和命名规则
未审核插件通常以 ZIP 或 Git 仓库形式提供，必须按结构放入对应目录：
-
Packages/目录用于源码形态：解压后整个文件夹（如VueSyntaxHighlight/）直接拖入，名称不能含空格或特殊字符，建议用纯英文小写 -
Installed Packages/目录仅接受.sublime-package文件：不能是 ZIP、不能重命名后缀、不能嵌套在子文件夹里 - 路径必须准确：macOS 是
~/Library/Application Support/Sublime Text 3/Packages/，Windows 是%APPDATA%\Sublime Text 3\Packages\，Linux 是~/.config/sublime-text-3/Packages/ - 装完不重启？Sublime 不会自动扫描新增文件夹——必须重启，或执行
sublime_text --debug启动时观察控制台是否报reloading plugin日志
如何验证插件是否真生效，而非“假安装”
常见假安装现象：命令面板能搜到插件名，但执行无反应；菜单栏出现条目，点击却报 No module named 'xxx'。验证要点如下：
- 打开一个明确匹配该插件作用域的文件（例如 Vue 插件需打开
.vue文件，不是.html） - 右下角状态栏检查当前语法是否为插件声明的支持类型（如显示 “Vue” 而非 “HTML”）
- 按
Ctrl+Shift+P输入插件命令全名（如Vue: Format Component），看是否可触发 - 打开
Preferences → Package Settings，确认对应插件菜单存在且配置项可编辑 - 若仍无效，打开控制台（
Ctrl+`），输入sublime.log_commands(True)，再试一次操作，看是否有日志输出
安全风险必须主动拦截的三个环节
未审核插件不经过 packagecontrol.io 的签名校验和沙箱扫描，执行任意 Python 代码——这意味着它能读取本地文件、调用系统命令、甚至反向连接远程服务器。关键防护动作：
- 安装前用
python -m zipfile -l plugin.sublime-package查看包内文件结构，警惕含__init__.py外还带os.system、subprocess.Popen、urllib.request的模块 - 首次运行时，在终端用
sublime_text --safe-mode启动，禁用所有插件，再逐个启用测试 - 检查插件 GitHub 仓库的提交历史：近 3 个月内无更新、作者无其他开源项目、Issue 区全是“怎么安装”，基本可判定为弃坑或可疑版本
最常被忽略的是作用域绑定和调试日志开关——很多插件只在特定语法下才加载，而 log_commands 一开，立刻暴露它根本没注册任何命令。
