必须手动绑定.pug后缀到Pug语法，否则即使装了插件也显示Plain Text；操作是打开.pug文件→右下角选Pug→再选“Open all with current extension as…”→确认Pug，且syntax字段须为"Packages/Pug/Pug.sublime-syntax"。
装了 Pug 插件，.pug 文件右下角还是 Plain Text？不是插件没装对，而是扩展名根本没绑定到语法——这一步必须手动触发，否则永远不生效。
为什么 .pug 文件打开后始终显示 Plain Text
常见错误现象：通过 Package Control 安装了 Pug 包，重启 Sublime，打开 index.pug，右下角仍显示 Plain Text 或 HTML。
根本原因：插件只提供 Packages/Pug/Pug.sublime-syntax 这个语法定义文件，它不会自动把 .pug 后缀和该语法关联起来。Sublime 对未知后缀一律当纯文本处理，从不“猜”你用什么语言。
- 如果右下角菜单里压根没有
Pug选项，说明插件未加载成功 → 尝试重启 Sublime，或重装Pug（别选Jade，2026 年主流维护的是Pug包） - 如果菜单里有
Pug，但点完就变回Plain Text，说明只改了当前文件，没执行“绑定全部”动作 - 部分用户跳过右下角两次点击，直接去手写配置，极易因大小写、路径或后缀写错导致失败
如何让 .pug 文件一打开就自动高亮
最稳妥的方式是用 Sublime 自带的「按扩展名绑定语法」功能，它会自动生成正确配置，避免手写出错：
立即学习“前端免费学习笔记（深入）”；
- 用 Sublime 打开任意一个
.pug文件 - 点击右下角显示的
Plain Text→ 在弹出菜单中选Pug - 再次点击右下角语言名（此时应显示
Pug）→ 选择Open all with current extension as…→ 确认选中Pug
这步会在 Packages/User/Preferences.sublime-settings 中写入类似这样的映射：
{
"extensions": ["pug"],
"syntax": "Packages/Pug/Pug.sublime-syntax"
}
注意：syntax 字段值必须严格满足三点：Packages/ 开头、Pug 大小写完全匹配（不是 pug）、后缀必须是 .sublime-syntax（不能是 .tmLanguage）。
Pug 和 Jade 插件到底该装哪个
2026 年主流维护的是 Pug 包（作者通常是 sublimelsp 或 lang-pug），Jade 包大多已停止更新，且 scope 名为 source.jade，与新主题不兼容。
- 在 Package Control 命令面板中搜
Pug，优先安装它 - 若搜不到
Pug，可临时试Jade，但后续自定义高亮或调试时大概率遇到 scope 不匹配问题（比如主题规则写的是source.pug，而 Jade 插件发的是source.jade，颜色就全白） - 不要混用：
"extensions": ["pug", "jade"]配置在同一段里，除非你确认插件同时支持两个 scope
检查配置是否真的生效
直接打开 Packages/User/Preferences.sublime-settings 文件，搜索 "syntax"，重点确认是否有这段映射，且格式完全正确：
- 漏掉
Packages/前缀 → 写成"syntax": "Pug/Pug.sublime-syntax" -
Pug写成小写 →"syntax": "Packages/pug/Pug.sublime-syntax" - 后缀用错 →
"syntax": "Packages/Pug/Pug.tmLanguage"（旧格式，新包只认.sublime-syntax）
scope 不匹配是最容易被忽略的点：即使语法高亮看起来正常，一旦换主题或调试嵌套结构，source.pug 和 source.jade 的差异会立刻暴露出来。
