Package Control未装好导致后续插件失效，验证方法是按Ctrl+Shift+P输入“Package Control: Install Package”，能响应并列出包列表才算成功；否则需用官网最新Python脚本在控制台执行并彻底重启Sublime。
Package Control 没装好，后面所有插件都白装——这是 90% 用户卡在第一步的真实原因。不是网络慢，是脚本没执行完、或没重启 Sublime。
Package Control 装没装成功，三秒验证法
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package。能立刻响应并列出包列表，才算真正就位。
如果命令灰色、无反应、或提示“command not found”，说明安装失败：
- 别点菜单里的
Preferences → Install Package Control——这个选项早在 Sublime Text 4 就被移除了 - 必须用官网最新 Python 3 脚本：打开
Ctrl+`控制台，粘贴 packagecontrol.io/installation 上的代码，**一次性回车执行**（不能手动换行） - 控制台输出
Package Control: Installed 1 package后，**必须彻底退出 Sublime 再重开**，否则命令面板不注册 - 国内用户若卡在
Loading packages，可临时把脚本里packagecontrol.io替成packagecontrol.cn
只装 MarkdownPreview 或只装 MarkdownEditing 都不行
这两个插件职责完全分离，缺一不可：
-
MarkdownEditing管「写」：提供标题高亮、列表自动缩进、Ctrl+Alt+1~6插入标题、代码块语言识别等——没它，.md文件打开就是Plain Text，白底黑字 -
MarkdownPreview管「看」：支持Ctrl+Shift+P → Markdown Preview: Preview in Browser实时预览、导出 HTML/PDF、启用enable_mathjax渲染公式——没它，你只能靠脑补渲染效果 - 拼写必须严格：
MarkdownEditing（带ing），不是MarkdownEditor；MarkdownPreview（无空格），不是Markdown Preview - 装完不用重启，但必须手动设置语法：打开任意
.md文件 → 点右下角Plain Text→ 选MarkdownEditing → Markdown GFM
MarkdownPreview 打不开浏览器？先查配置再查路径
点预览没反应、弹空白页、或控制台报 [Errno 13] Permission denied，基本和插件无关，而是系统拦截了浏览器调用。
- Windows 最常见：默认 Chrome 路径含空格（如
C:\Program Files\Google\Chrome\Application\chrome.exe），直接触发权限拒绝 - 解决办法：打开
Preferences → Package Settings → MarkdownPreview → Settings – User，加一行："browser": "default" - 非要指定 Chrome：路径改用正斜杠 + 无空格路径，例如
"browser": "C:/Chrome/chrome.exe" - macOS 预览空白？先关 Safari/Chrome 的「阻止弹出窗口」，或临时切
"browser": "safari" - 预览显示原始 Markdown 源码？检查设置里是否设了
"parser": "github"，且"enabled_parsers"包含"github"
数学公式不渲染、表格错位、Mermaid 不生效？
这些不是插件坏了，而是解析器和 CSS 模式没对齐。
- 公式不显示：在
MarkdownPreview的Settings – User里加"enable_mathjax": true，并确认"parser": "github" - 表格错位、任务列表不渲染：原生
markdown解析器不支持 GFM 特性，必须用github模式 - Mermaid 图表不加载：需额外启用
"enable_mermaid": true，且确保你用的是 GitHub 渲染器（"parser": "github"） - 中文路径报
UnicodeEncodeError？文件保存路径不能含中文，或在设置里加"encoding": "UTF-8"
.md 文件是否被识别为 Markdown GFM、预览是否走 github 解析器、浏览器调用路径是否绕过系统权限限制——这三处任一断链，整个流程就卡死。 
