Pug文件在Sublime中显示Plain Text是因为.pug后缀未绑定语法，必须手动通过右下角菜单选择Pug并执行“Open all with current extension as…”以写入正确syntax路径；配置中syntax字段须严格为"Packages/Pug/Pug.sublime-syntax"。
Pug 文件在 Sublime Text 中显示为 Plain Text，不是插件没装，而是 .pug 后缀根本没绑定到语法定义——这一步必须手动完成，否则永远不生效。
为什么 .pug 文件打开后右下角始终显示 Plain Text
常见现象：已用 Package Control 安装了 Pug 插件，重启 Sublime，打开 index.pug，右下角仍显示 Plain Text 或误判为 HTML。这不是插件失效，而是 Sublime 默认对未知扩展名不做任何语法推断，.pug 不在默认支持列表里，必须显式关联。
- 如果右下角语言菜单里压根没有
Pug选项 → 插件未加载成功（尝试重启，或重装Pug；别选Jade，2026 年主流维护的是Pug包） - 如果点了
Pug后右下角短暂显示 Pug 又变回 Plain Text → 你只改了当前文件，没执行“绑定全部”动作 - 如果手写配置但无效 → 很可能
syntax字段写成了Packages/pug/Pug.tmLanguage或漏了Packages/前缀
如何让 .pug 文件一打开就自动高亮（最稳操作）
Sublime 自带的「按扩展名绑定语法」功能会自动生成正确配置，避免手写 YAML 出错。顺序不能颠倒：
- 用 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）。
Emmet 在 Pug 中能用吗？怎么触发缩写
能用，但默认不启用 —— Emmet 对 Pug 的支持需额外开启，且缩写语法与 HTML 不同。
- 确认已安装
Emmet（通过 Package Control），并确保当前文件语法为Pug（右下角显示） - 打开
Preferences → Package Settings → Emmet → Settings，在用户设置中添加：
{
"syntax_scopes": {
"Pug": "source.pug"
}
}
之后即可输入 Pug 缩写，例如：
-
html:5+Tab→ 生成doctype html结构 -
.container>ul>li*3+Tab→ 展开为带缩进的嵌套结构 -
script[src="app.js"]+Tab→ 生成script(src="app.js")
注意：Tab 是默认触发键；若失效，请检查光标是否在行尾、有无选中文本、或缩写含中文/全角字符。
保存后如何预览 Pug 渲染效果
Sublime Text 本身不编译 Pug，也不起服务 —— 所谓“实时预览”，必须靠外部工具链配合。
- 轻量方案：用
pug-cli监听文件变化，自动编译为.html，再用浏览器打开该 HTML（推荐命令：pug --watch --pretty index.pug -o ./dist/） - 集成方案：安装
Live Server插件，但它只服务静态 HTML；你需要先编译好 HTML，再用它打开dist/index.html，才能获得保存即刷新体验 - 避坑提示：别指望
Open In Browser直接打开.pug文件 —— 浏览器无法解析 Pug 源码，只会下载或报错
真正容易被忽略的是：Pug 缩进敏感，且 include、extends 路径基于编译时工作目录，不是 Sublime 当前打开的文件路径。调试时建议统一在项目根目录执行编译命令，而非从子目录双击打开 .pug 文件。
