插件文件须按类型分放：.sublime-package 文件进 installed packages/，github zip 解压后的文件夹（重命名后）进 packages/；路径错误、ignored_packages 屏蔽、语法不匹配、package control 版本或校验失败是离线安装失败主因。
插件文件该放 Packages 还是 Installed Packages？
放错目录是离线安装失败的头号原因。Sublime 对这两个目录有硬性分工，混放等于白装：
• .sublime-package 文件（如 Emmet.sublime-package）→ 必须直接拖进 Installed Packages/ 目录，不解压、不改名、不嵌套子文件夹
• GitHub 下载的 ZIP 解压后得到的文件夹（如 Emmet-master/）→ 必须整体复制进 Packages/ 根目录，且文件夹名要和插件官方名完全一致（删掉 -master，大小写敏感）
• 怎么确认路径？菜单 Preferences → Browse Packages… 打开的就是 Packages/；它的上一级目录里的 Installed Packages/ 才是另一个位置
• 不确定？按 Ctrl+` 调出控制台，输入 print(sublime.packages_path()) 和 print(sublime.installed_packages_path())，回车看真实路径
GitHub 下载的 ZIP 插件解压后怎么重命名才有效？
GitHub 自动生成的 -main 或 -master 后缀是包装壳，Sublime 完全不识别：
• 解压后进到那层文件夹里，找到含 __init__.py 或主模块文件（如 git_gutter.py）的子目录
• 把整个子目录剪出来，重命名为干净名称：例如 GitGutter-main/ → GitGutter/，Origami-dev/ → Origami/
• 名字必须大小写严格匹配插件官方文档，不能带空格、下划线、点号或版本后缀
• 重命名后的整个文件夹，直接拖进 Packages/ 根目录——不是 Packages/User/，也不是 Installed Packages/
插件放对了但命令搜不到、快捷键没反应？
大概率不是没装上，而是被 Sublime 主动跳过了：
• 打开 Preferences → Settings，检查右侧用户配置中是否有 "ignored_packages" 字段；如果刚装的插件名（比如 "Emmet"）正好在列表里，它就被静默屏蔽
• 删掉对应项，或整行注释掉，保存后必须**完全退出 Sublime**（macOS 用 Dock 右键 Quit，Windows 结束所有 subl.exe 进程），再重启才生效
• 插件常只在特定语法下触发：比如 Vue Syntax Highlight 只响应 .vue 文件或作用域 text.html.vue；打开纯 .html 文件时右下角显示 HTML，它就彻底沉默
• 按 Ctrl+Shift+P 输入 Set Syntax: 手动切换语法，再试命令
Package Control 离线安装为什么总失败？
ST4 对 Package Control 的校验极严，旧脚本或控制台命令会静默失败：
• 先运行 sublime.version() 确认返回值是 4xxx
• 关闭 Sublime Text，进 Installed Packages/ 目录，删掉所有含 Package Control 字样的文件（包括 Package Control.sublime-package 和残留文件夹）
• 去国内镜像下载完整包（如 https://www.php.cn/link/7574933a1b39d861a171370e4582ec28），文件大小必须在 180–220 KB；小于 100 KB 就是下载不全，丢弃重试
• 把下载好的 Package Control.sublime-package 文件直接拖入 Installed Packages/，不解压、不改名、不放进子文件夹
• 重启后按 Ctrl+Shift+P 搜 Package Control: List Packages，能列出已装插件才算真正加载成功
ignored_packages 列表也从不报错，只让插件彻底消失。动手前多看一眼当前版本和真实路径，比反复重启更省时间。
