最稳妥的方式是用sublime自带的「按扩展名绑定语法」功能：打开.pug文件→右下角选pug→再选open all with current extension as…→确认pug，自动写入用户配置。
Sublime 默认不支持 Pug（原 Jade）语法高亮，必须手动安装或配置对应语法定义，否则打开 .pug 文件只会显示为 Plain Text，所有缩进、关键字、插值都无颜色区分。
怎么让 .pug 文件一打开就自动高亮
最稳妥的方式是用 Sublime 自带的「按扩展名绑定语法」功能，它会直接写入用户配置，无需手写路径或担心大小写错误：
- 先用 Sublime 打开任意一个
.pug文件 - 点击右下角当前显示的
Plain Text→ 在弹出菜单中选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 语法包的两种方式（推荐 Package Control）
绝大多数用户应优先走 Package Control 安装，避免手动配错 YAML 结构或 scope：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Install Package，回车后等待列表加载 - 搜索
Pug，选中并安装（常见包名是Pug或Jade；2026 年主流维护的是Pug包） - 安装完重启 Sublime 或直接打开
.pug文件，右下角应显示Pug
如果搜不到 Pug，可尝试 Jade，但要注意：旧版 Jade 包可能仍用 source.jade scope，而新 Pug 推荐用 source.pug；若后续自定义主题时发现高亮不生效，大概率是 scope 不匹配。
手动添加 Pug.sublime-syntax 的关键校验点
如果你需要定制规则（比如支持 != 非转义插值或特定 mixin 语法），必须手写 .sublime-syntax 文件。以下三点极易出错，务必核对：
-
scope字段必须为source.pug（不是text.pug或pug），否则主题无法将颜色规则应用到该文件 -
file_extensions列表里必须包含- pug（注意前面是短横线加空格，不是冒号或等号） - 文件必须保存在
Packages/User/Pug/Pug.sublime-syntax（路径含User，文件名大小写敏感，结尾必须是.sublime-syntax）
验证是否生效：新建一个 test.xyz，手动设语法为 Pug，看右下角是否立刻变成 Pug；如果还是 Plain Text，说明文件未被 Sublime 加载，多半是路径或命名错了。
为什么 Pug 高亮看起来“淡”或关键字不显眼
这不是语法包问题，而是当前 color scheme 没为 source.pug 下的常见 scope 定义足够对比度的颜色。Pug 依赖的 scope 包括 keyword.control（if、each）、variable.language（item）、string.interpolated（#{name}）等。
解决方法不是改语法文件，而是检查你用的主题是否覆盖了这些 scope：
- 用
Ctrl+Shift+P→PackageResourceViewer: Open Resource→ 选当前主题 → 找.sublime-color-scheme - 搜索
keyword.control，确认有对应 rule；若没有，复制一段通用定义粘贴进去，例如：
{
"name": "Pug keyword",
"scope": "keyword.control.pug, keyword.control.source.pug",
"foreground": "#C792EA"
}
注意：scope 值要带上 .pug 后缀才精准，否则可能误染其他语言的关键字。这类细节在调试时最容易被跳过，结果调半天语法文件，其实只是主题缺一行配色。
