关键在于放对路径和命名准确：packages目录放解压后的插件文件夹，installed packages目录放原样.sublime-package压缩包；路径须通过preferences→browse packages…或控制台执行sublime.packages_path()与sublime.installed_packages_path()确认，不可依赖默认路径。
离线安装 Sublime Text 插件，关键不是“怎么下”，而是“放哪”和“叫什么”——文件位置错、文件夹名大小写不对、或被 ignored_packages 静默屏蔽，插件就会彻底消失，控制台还不报错。
怎么确认 Packages 和 Installed Packages 的真实路径？
别信网上搜来的默认路径，ST4 在不同系统、安装方式（dmg / exe / snap / 便携版）下路径都可能不同。最稳的方式是让 Sublime 自己告诉你：
- 打开 Sublime Text，菜单栏选 Preferences → Browse Packages…，弹出的窗口地址就是
Packages目录 - 在这个窗口里，按
Cmd + ↑（macOS）或Alt + ↑（Windows/Linux）上退一级，找到Installed Packages文件夹 - 不确定？按
Ctrl+`调出控制台，输入：import sublime; print(sublime.packages_path())<br>print(sublime.installed_packages_path())
回车后直接看到两个绝对路径
.sublime-package 文件必须扔进 Installed Packages/
这类文件是预打包的压缩包（本质是 zip），Sublime 只在 Installed Packages 目录下扫描它。常见错误包括：
- 拖进了
Packages/目录 —— Sublime 完全忽略，不报错也不加载 - 解压了再放进去 —— .sublime-package 就是最终形态，解压后反而失效
- 改名了（如
PackageControl.sublime-package→PC.sublime-package）—— 名字必须原样，大小写一个都不能错 - 文件损坏：下载不全（大小 https://packagecontrol.cn/Package%20Control.sublime-package
GitHub 下载的 ZIP 插件要重命名后整个塞进 Packages/
从 GitHub 点 Download ZIP 得到的压缩包，解压后默认带 -master 或 -main 后缀（如 Emmet-master/），这层是 GitHub 自动生成的包装壳，Sublime 不识别。
- 必须手动进入该文件夹，把里面真正含
__init__.py或主模块（如git_gutter.py）的子目录拎出来 - 重命名为插件官方名，例如：
Emmet-master/→Emmet/，Origami-dev/→Origami/，ConvertToUTF8-main/→ConvertToUTF8/ - 大小写必须完全一致：
PyV8≠pyv8≠Pyv8；不能加空格、下划线或点号 - 整个重命名后的文件夹，直接拖进
Packages/根目录（不是Packages/User/，也不是Packages/Default/）
插件放对了却没反应？先查 ignored_packages 和语法作用域
这是最隐蔽的失败原因：文件在位、重启也做了，但命令面板搜不到、快捷键无效、菜单不出现——Sublime 其实加载了，只是主动跳过了。
- 打开 Preferences → Settings，看右侧用户设置中是否有
"ignored_packages"字段；如果刚装的插件名（如"Emmet"）正好在里面，它就被静默禁用 - 插件常只在特定语法下生效：比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域；开纯.html文件时右下角显示HTML，它就完全沉默 - 验证方法：按
Ctrl+Shift+P输入Set Syntax:，手动切换语法，再试命令；或临时注释掉ignored_packages行，保存后彻底重启
最容易被忽略的是：Sublime 从不提示“你放错地方了”，它只是沉默跳过；ignored_packages 列表也不会报错，只让插件彻底消失。每次重启前，务必杀掉所有后台进程（macOS 用活动监视器，Windows 用任务管理器），否则旧模块可能还在内存里。
