pug语法高亮需同时安装pug语法包并手动绑定.pug后缀，否则文件默认为plain text；右下角显示plain text说明未正确关联语法，须通过右下角菜单选择pug并执行“open all with current extension as…”，且配置中syntax字段必须为packages/pug/pug.sublime-syntax。
Pug 语法高亮在 Sublime 中不会自动生效，必须安装语法包 + 手动绑定 .pug 后缀，缺一不可；否则打开文件永远是 Plain Text。
为什么装了 Pug 插件右下角还是 Plain Text
常见错误现象：用 Package Control 安装了 Pug 包，重启 Sublime，打开 index.pug，右下角仍显示 Plain Text 或 HTML。
根本原因不是插件没装好，而是 Sublime 没把 .pug 扩展名和 Pug 语法关联起来——插件只提供语法定义（Pug.sublime-syntax），不自动注册后缀。
- 必须先让 Sublime 认出这个语法：打开任意
.pug文件 → 点右下角Plain Text→ 选Pug（如果菜单里没有，说明插件未加载成功，需重启或重装） - 再执行“Open all with current extension as…” →
Pug，这步才会写入Packages/User/Preferences.sublime-settings中的映射 - 检查生成的配置是否含
"syntax": "Packages/Pug/Pug.sublime-syntax"——大小写、Packages/前缀、.sublime-syntax后缀三者缺一不可
安装 Pug 语法包该搜 “Pug” 还是 “Jade”
2026 年主流维护的是 Pug 包（作者：sublimelsp 或 lang-pug），Jade 包大多已停止更新，且 scope 名为 source.jade，与新主题不兼容。
若搜 Pug 无结果，可临时试 Jade，但后续自定义高亮或调试时大概率遇到 scope 不匹配问题（比如主题规则写的是 source.pug，而 Jade 插件发的是 source.jade，颜色就全白）。
- 推荐安装顺序：
Ctrl+Shift+P→Package Control: Install Package→ 输入Pug→ 回车 - 安装后务必重启 Sublime，否则新语法不会出现在右下角语言菜单中
- macOS 用户若通过 Dock 启动 Sublime，有时 Package Control 列表空白，改用终端执行
open -a "Sublime Text"可修复 PATH 问题
手动绑定 .pug 后缀失败的三个硬性校验点
即使点了“Open all with current extension as…”，也可能因路径、命名或字段错误导致绑定静默失效。以下三点必须人工核对：
-
syntax字段值必须以Packages/开头，且完整拼写为Packages/Pug/Pug.sublime-syntax（注意：不是Packages/pug/...，大小写敏感） - 生成的配置应落在
Packages/User/Preferences.sublime-settings中，结构为：{"extensions": ["pug"], "syntax": "Packages/Pug/Pug.sublime-syntax"}——不能写成"extensions": "pug"（字符串非数组） - 如果之前手动改过
Packages/HTML/HTML.sublime-settings，可能覆盖默认行为；不要动系统包，所有修改只放在Packages/User/下
验证是否真生效：别只看 index.pug
最可靠的验证方式不是打开已有文件，而是新建一个测试文件：
- 按
Ctrl+N新建空白页 →Ctrl+S保存为test.pug→ 观察右下角是否直接显示Pug - 光标停在
h1 Hello #{name}的h1上，按Ctrl+Shift+P→ 输入Show Scope Name回车，应看到类似source.pug meta.tag.block.pug entity.name.tag.pug的链；若只显示text.plain，说明语法未加载 - 若高亮颜色不对（比如关键字仍是灰色），问题不在语法包，而在当前
color_scheme是否支持source.pug下的 scope，此时需查主题文件 rules 中是否包含对应条目
真正容易被忽略的是：Pug 是缩进敏感语法，Sublime 的语法解析器对空格/Tab 混用极其敏感；哪怕一行开头多了一个空格，整块结构就可能降级为 plain text，此时高亮会局部失效，而非全文件失效——得逐行检查缩进一致性。
