装完Pug插件后.pug文件仍显示Plain Text，是因为Sublime未将.pug后缀与Pug语法绑定；需手动通过右下角菜单选择“Open all with current extension as…→Pug”完成关联。
装完 Pug 插件后 .pug 文件仍显示 Plain Text，不是插件没装好，而是 Sublime 根本没把 .pug 后缀和语法关联起来——这一步必须手动触发，否则永远不生效。
右下角始终是 Plain Text 怎么办
常见错误现象：index.pug 打开后右下角显示 Plain Text，即使已通过 Package Control 安装了 Pug 包。
- 根本原因不是插件失效，而是 Sublime 不知道该用哪个语法解析
.pug文件 - 插件（如
Pug）只提供Packages/Pug/Pug.sublime-syntax定义，不自动注册扩展名 - Sublime 默认对未知后缀一律当作
Plain Text，不会尝试猜测 - 如果右下角菜单里压根没有
Pug选项，说明插件未加载成功（需重启 Sublime 或重装） - 若菜单中有
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）
前端设计优化skill
下载
前端设计与 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 文件内容，重点看是否有这段映射。最容易被忽略的是三处硬性要求：
-
syntax值必须以Packages/开头（不能是./Pug/...或相对路径） - 大小写必须完全一致：
Pug.sublime-syntax≠pug.sublime-syntax≠PUG.sublime-syntax - 后缀必须是
.sublime-syntax（老教程里常见的.tmLanguage在 ST4 中已不被支持） - 如果同时装了多个模板插件（如
Jade和Pug），它们的 scope 可能冲突，导致部分关键字失色
真正复杂的地方在于：Sublime 的语法系统不校验配置合法性，写错也不会报错，只会静默降级为 Plain Text——你得自己去查配置、比对路径、确认 scope 是否被主题支持。
