preferences → browse packages… 是唯一可信路径，它始终指向当前生效的真实插件目录，无论系统、版本或安装方式；手动拼路径易失效，installed packages 仅存压缩包，packages 才是运行时加载位置。
Preferences → Browse Packages… 是唯一可信路径
别记路径，也别猜。Sublime Text 实际加载插件的位置就是 Packages 目录，而 Preferences → Browse Packages… 菜单项会直接在文件管理器中打开它——无论你用的是 Windows、macOS 还是 Linux，也无论 Sublime Text 3 还是 4，甚至便携版、Snap/Flatpak 安装，这个入口永远指向当前生效的真实目录。
常见错误是手动拼路径：%APPDATA%\Sublime Text\Packages（Win）、~/Library/Application Support/Sublime Text/Packages（macOS）、~/.config/sublime-text\Packages（Linux）。这些只是默认值，一旦启用便携模式、自定义 data 目录，或升级迁移过配置，就立刻失效。
- 便携版用户：插件目录就在你解压根目录下的
Data\Packages - Snap/Flatpak 用户：沙盒隔离导致路径不可见，
Browse Packages…是唯一能打开的入口 - 多版本共存（ST3 + ST4）：每个版本有独立
Packages目录，不能混用
Installed Packages 和 Packages 的分工必须分清
Installed Packages 只存 .sublime-package 压缩包，是 Package Control 下载的缓存；Packages 才是运行时加载的位置，里面放的是解压后的同名文件夹（比如 Packages/GitGutter/）。
手动安装时，路径选错 = 插件不生效：
- 下载的是
Emmet.sublime-package→ 直接丢进Installed Packages，不要解压 - 下载的是
Emmet-master.zip或 GitHub 源码 → 解压出Emmet文件夹（注意大小写），整个文件夹复制进Packages顶层，不能嵌套 -
Packages目录的上一级才是Installed Packages，别把文件夹拖错层级
插件放对了却没反应？先查 ignored_packages
命令面板搜不到、快捷键不触发、菜单不出现——90% 是被 Sublime 主动忽略了。打开 Preferences → Settings，看右侧用户配置里有没有 "ignored_packages" 字段。
- 如果刚放进去的插件名（比如
"Emmet"）出现在这个列表里，它就被静默禁用了 - 删掉对应项，或临时注释整行，保存后重启验证
- 大小写敏感：macOS/Linux 下
emmet文件夹 ≠Emmet配置名，加载会失败 - 控制台输入
import sublime; sublime.packages_path()可验证路径是否真被识别，返回None说明 Sublime 尚未初始化完成，需重启
离线更新插件必须删旧再放新
Sublime 会缓存模块导入状态，覆盖同名文件基本无效。比如你手动替换 Packages/Emmet/ 下的文件，很可能无反应。
- 正确做法：先删掉整个
Packages/Emmet/文件夹，再把新版本解压进去 - 如果插件是从
.sublime-package安装的，也要先从Installed Packages删除对应文件，再放新包 - 更新后若仍异常，可尝试关闭 Sublime，清空
Packages/下的.cache类临时文件（如有），再重启
最容易被忽略的一点：插件迁移或调试时，很多人只复制 Packages/User，结果新环境里插件命令全报 command not found——因为插件代码本身不在 User 里，而在 Packages/插件名/ 下。
