.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中写入类似这样的映射:
{
"extensions": ["pug"],
"syntax": "Packages/Pug/Pug.sublime-syntax"
}
注意:syntax字段值必须严格满足三点:以Packages/开头、大小写完全匹配(Pug不是pug)、后缀必须是.sublime-syntax(不能是.tmLanguage)。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。
安装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用。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










