package control真正装好必须能执行命令:按ctrl+shift+p输入package control: install package,弹出搜索框且状态栏显示fetching list of available packages才算成功。

Package Control 命令能执行才算真正装上了
插件安装失败,八成卡在 Package Control 这一层。很多人看到菜单里多了 Preferences → Package Settings → Package Control 就以为装好了,其实那是旧版残留 UI,完全不可信。
真正有效的验证方式只有一种:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control: Install Package —— 必须能立刻响应、弹出搜索框,并在状态栏显示 Fetching list of available packages,才算通路打通。
如果命令灰色、无反应、或提示 command not found,说明 Package Control 没加载进运行时环境,后续所有插件都白装。
- 控制台执行安装脚本后,必须等满 5 秒再判断;右下角出现
Successfully installed Package Control才算成功 - 手动安装时,
sublime.installed_packages_path()返回的路径才是真实Installed Packages/目录,不能靠猜 - 装完必须彻底退出 Sublime(Windows 杀掉所有
subl.exe,macOS 用 Activity Monitor 结束进程),否则插件管理器不初始化
插件名出现在 Package Control 列表里 ≠ 安装成功
输入 Package Control: List Packages 能弹出列表(哪怕为空),只说明插件管理器能读取已安装包;但具体某个插件是否生效,得看它有没有被 Sublime 主动忽略。
常见静默失效原因不是没装上,而是被屏蔽了:
- 检查用户设置中是否有
"ignored_packages": ["ChineseLocalization"]这类配置,刚装的插件名在里面就会被跳过加载 -
.sublime-package文件必须放进Installed Packages/目录;解压后的文件夹必须整体扔进Packages/,不能嵌套子目录 - 某些插件依赖底层模块(比如
mdpopups),若报ImportError: No module named 'mdpopups',说明依赖没随插件一起装全
右下角语法标识和命令面板是实时检测关键
插件是否真在工作,最直接的观察点是右下角状态栏的语法标识和命令面板能否调出对应功能。
例如装了 MarkdownPreview,但打开 .md 文件后右下角显示的是 Plain Text,那根本不会触发预览——它只对语法设为 Markdown GFM 或 MultiMarkdown 的文件响应。
- 手动切换语法:
Ctrl+Shift+P→ 输入Set Syntax: Markdown GFM回车 - 再呼出命令面板,搜
Markdown Preview: Preview in Browser,能看见且可执行才算加载成功 - 若命令面板里搜不到,但
Package Control: List Packages显示插件在列表里,大概率是ignored_packages或路径放错
浏览器弹窗空白或报错 command not found 是编辑层缺失
装了 MarkdownPreview 却点开空白页,或者控制台报 command not found: markdown_preview,这不是插件本身的问题,而是编辑层没配好。
典型链路断裂点:
- 没装
MarkdownEditing插件(MarkdownPreview依赖它提供语法支持) - 文件虽是
.md后缀,但语法未手动设为Markdown GFM(右下角点击切换) - 用户设置里禁用了相关命令,比如在
Key Bindings – User中覆盖了默认快捷键却没写对command名
复杂点在于:Sublime 的插件生效依赖语法作用域、配置路径、加载顺序三者同时满足。少一个条件,看起来像“装了但没用”,实际是根本没进入执行上下文。











