必须手动绑定.pug后缀到pug语法，否则即使装了插件也显示plain text；操作是打开.pug文件→右下角选pug→再选“open all with current extension as…”→确认pug，且syntax字段须为"packages/pug/pug.sublime-syntax"。
装完Pug插件，.pug文件还是Plain Text？
不是插件没装好，而是Sublime根本没把.pug后缀和语法关联起来——它不会自动“猜”你用什么语言。哪怕你已通过Package Control安装了Pug包，打开index.pug右下角仍显示Plain Text，就说明这一步没走完。
常见错误包括：
- 右下角菜单里压根没有
Pug选项 → 插件未加载成功，尝试重启Sublime或重装Pug（别选Jade，2026年主流维护的是Pug包） - 点了
Pug但一关闭再打开又变回Plain Text→ 只改了当前文件，没执行“绑定全部”动作 - 手动编辑
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.vue scope，不主动转发lang="pug"到source.pug scope。
该装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不匹配问题 - 不要混用：
"extensions": ["pug", "jade"]配置在同一段里，除非你确认插件同时支持两个scope
真正容易被忽略的点是：即使配置写对了，如果Packages/Pug/Pug.sublime-syntax文件被杀毒软件拦截、或插件被禁用，控制台（Ctrl+`）会报错，但界面毫无提示。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
