.pug文件打开显示Plain Text是因为Sublime未将.pug后缀关联到Pug语法;需手动通过右下角菜单选择Pug→“Open all with current extension as…”完成绑定,并确保配置中syntax路径为Packages/Pug/Pug.sublime-syntax。

为什么.pug文件打开后还是Plain Text
不是插件没装,是Sublime根本没把.pug后缀和Pug语法关联起来——它不会自动“猜”你用什么语言。哪怕你已通过Package Control安装了Pug包,右下角仍显示Plain Text,就说明这一步没走完。
- 右下角菜单里压根没有
Pug选项 → 插件未加载成功,尝试重启Sublime或重装Pug(别选Jade,2026年主流维护的是Pug包) - 点了
Pug但一关闭再打开又变回Plain Text→ 只改了当前文件,没执行“Open all with current extension as…”动作 - 手动编辑
Preferences.sublime-settings时写错路径:漏掉Packages/前缀、Pug写成pug、或用了.tmLanguage而非.sublime-syntax
怎么让.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。
Vue单文件组件里写Pug模板没高亮
Sublime只认文件后缀,不解析<template lang="pug"></template>这类内容。想让.vue里的Pug片段高亮,得靠插件做语法嵌套映射:
- 确认已装
Pug语法包和Vue Syntax Highlight插件 - 在
Preferences > Package Settings > Vue Syntax Highlight > Settings – User中添加:
"pug": { "enabled": true }
如果没有这个设置项,高亮永远不会触发——.vue文件默认用source.vuescope,不主动转发lang="pug"到source.pugscope。
该装Pug还是Jade
2026年主流维护的是Pug包(作者通常是sublimelsp或lang-pug),Jade包大多已停止更新,且scope为source.jade,与新主题规则(如source.pug)不兼容。
- 安装建议:按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)调出命令面板 - 输入
Install Package,回车后等待列表加载 - 搜索
Pug,选中并安装
如果搜不到Pug,可临时试Jade,但后续自定义主题或调试时大概率遇到scope不匹配问题——比如主题规则写的是source.pug,而Jade插件发的是source.jade,颜色就全白。


















