.pug文件显示Plain Text是因为Sublime未将扩展名与Pug语法绑定；需手动通过右下角菜单选择“Open all with current extension as…→Pug”完成关联，确保Preferences.sublime-settings中配置为"extensions": ["pug"], "syntax": "Packages/Pug/Pug.sublime-syntax"。
装了Pug插件但.pug文件还是Plain Text？不是插件坏了，是Sublime根本没把.pug后缀和语法关联上——这一步必须手动做，跳过就永远不亮。
为什么右下角始终显示Plain Text
常见错误现象：index.pug打开后右下角显示Plain Text，甚至显示HTML；点开右下角菜单也找不到Pug选项。
- 根本原因：Package Control安装的只是
Pug.sublime-syntax文件，它不自动注册.pug扩展名；Sublime默认对未知后缀一律当Plain Text处理 - 如果菜单里压根没有
Pug，说明插件未加载成功——需重启Sublime或重装Pug包（别选Jade，2026年主流维护的是Pug） - 如果菜单里有
Pug但点完仍不持久，说明只改了当前文件，没执行“绑定全部”动作
如何让.pug文件一打开就自动高亮
最稳妥的方式是用Sublime自带的「按扩展名绑定语法」功能，它会自动生成正确配置，避免手写路径出错：
- 用Sublime打开任意一个
.pug文件 - 点击右下角显示的
Plain Text→ 在弹出菜单中选Pug - 再次点击右下角语言名（此时应显示
Pug）→ 选择Open all with current extension as…→ 确认选中Pug
这一步会在Packages/User/Preferences.sublime-settings中写入类似这样的映射：
立即学习“前端免费学习笔记（深入）”；
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
{
"extensions": ["pug"],
"syntax": "Packages/Pug/Pug.sublime-syntax"
}
注意：syntax字段值必须严格满足三点：以Packages/开头、大小写完全匹配（Pug不是pug）、后缀必须是.sublime-syntax（不能是.tmLanguage）。
安装Pug语法包的正确方式
绝大多数用户应走Package Control安装，避免手动配错YAML结构或scope：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Install Package，回车后等待列表加载 - 搜索
Pug，选中并安装（2026年主流维护的是Pug包；若搜不到，可试Jade，但注意旧版可能用source.jadescope，而新Pug推荐source.pug） - 安装完无需重启，直接打开
.pug文件，右下角应显示Pug
若后续自定义主题时发现高亮不生效，大概率是scope不匹配——比如插件用了source.pug，但你的color scheme只定义了source.jade的颜色。
检查syntax配置是否生效
直接检查Packages/User/Preferences.sublime-settings文件内容，重点看是否有这段映射：
"extensions": ["pug"], "syntax": "Packages/Pug/Pug.sublime-syntax"
三个细节最容易被忽略：大小写（Pug ≠ pug）、前缀（必须是Packages/）、后缀（必须是.sublime-syntax）。少一个，.pug文件就只能继续当Plain Text用。
