Package Control 必须放入 Installed Packages 目录,GitHub 插件文件夹需重命名后放入 Packages 根目录;路径必须通过 Preferences → Browse Packages… 或控制台执行 sublime.installed_packages_path() 和 sublime.packages_path() 精确获取,不可猜测或套用网络默认路径。

Package Control 必须放进 Installed Packages 目录,GitHub 下载的插件文件夹必须重命名后扔进 Packages 根目录——路径错、命名错、没清残留进程,三者任一出问题,插件就静默失效。
怎么确认该往哪个目录丢文件?
别猜路径,也别复制网上搜来的默认地址。不同系统、ST3/ST4、便携版路径全不同,唯一可靠方式是:Preferences → Browse Packages… 打开的那个文件夹就是 Packages 目录;它的上一级里那个叫 Installed Packages 的文件夹,才是放 .sublime-package 文件的地方。
不确定?按 Ctrl+` 调出控制台,输入:
import sublime; print(sublime.packages_path())<br>import sublime; print(sublime.installed_packages_path())
回车后直接看到真实路径,复制粘贴到文件管理器里打开就行。
.sublime-package 文件和解压文件夹不能混放
Sublime 对这两类文件有硬性分工:
-
.sublime-package文件(如Package Control.sublime-package、Emmet.sublime-package)→ 必须直接拖进Installed Packages目录,不解压、不改名、不嵌套子文件夹 - 从 GitHub 下载 ZIP 解压出来的文件夹(如
Emmet-master/、Origami-dev/)→ 必须重命名为规范名(Emmet/、Origami/),再整体拖进Packages根目录(不是Installed Packages,也不是Packages/User/) - 大小写必须完全一致:Windows 上看着一样也不行,
emmet/和Emmet/是两个东西
为什么插件放对了却搜不到命令?
大概率不是没装上,而是被 Sublime 主动跳过了:
- 打开 Preferences → Settings,检查右侧用户设置里是否有
"ignored_packages"字段;如果刚放进去的插件名(比如"Emmet")在里面,它就被静默屏蔽 - 插件常只在特定语法下生效:比如
VueSyntaxHighlight只响应.vue文件或text.html.vue作用域,开纯.html文件时右下角显示HTML,它就彻底沉默 - 重启后立刻按
Ctrl+Shift+P输入插件名,没反应就打开控制台看有没有reloading plugin XXX failed或ImportError
离线装 Package Control 最容易翻车的点
ST4 尤其严格:控制台显示 Package Control installed 不等于真能用,旧脚本会静默失败。
- 先运行
sublime.version()确认返回值是4xxx - 关闭 Sublime Text,进
Installed Packages目录,删掉所有含Package Control字样的文件(包括Package Control.sublime-package和可能残留的文件夹) - 去可信镜像下载完整包(大小必须在
180–220 KB;小于100 KB就是下载损坏) - 拖入
Installed Packages后,必须彻底退出再重开——macOS 要用 Activity Monitor 杀掉所有subl进程,Windows 要在任务管理器里结束全部subl.exe - 重启后按
Ctrl+Shift+P输入Package Control: List Packages,能列出插件才算真正加载成功
ignored_packages 列表也不会弹任何警告,只会让插件彻底消失。验证是否生效,永远以控制台日志和命令面板响应为准,而不是“文件在不在”。

















