preferences → browse packages…是唯一可信路径,它直接打开当前生效的packages目录,无论系统、版本或安装方式;其上一级的installed packages目录用于存放.sublime-package文件,二者分工明确,路径选错则插件不生效。

Preferences → Browse Packages… 是唯一可信路径
别记路径,也别猜。Sublime 的插件实际加载位置就是 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目录下对应插件的整个文件夹(如Packages/Emmet) - 再把新版解压后的文件夹放进去
- 重启 Sublime Text
共享插件依赖路径一致性,但真正起作用的从来不是“你认为该放哪”,而是 Sublime 实际加载的 Packages 目录——而它只认 Browse Packages… 打开的那个位置。











