必须手动将.pug扩展名绑定到Pug语法，否则始终显示Plain Text；先右下角选Pug，再选Open all with current extension as…，才能持久生效。
装完 Pug 插件后 .pug 文件仍显示为 Plain Text，不是插件没装好，而是 Sublime 根本没把后缀和语法关联起来——这一步必须手动触发，否则永远不生效。
为什么右下角始终是 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）。
前端设计与 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 的颜色。
检查与排错关键点
绑定后仍不生效？优先查这几个地方：
- 打开 Sublime 控制台（
Ctrl+`），看是否有Failed to load syntax或Unable to find syntax报错 - 确认
Packages/User/Preferences.sublime-settings中的syntax值是否含拼写错误、大小写错误或漏掉.sublime-syntax - 检查插件是否被禁用：菜单 →
Preferences→Package Settings→ 看Pug是否在列表中且无灰色禁用标记 - 某些主题或插件（如 ApplySyntax）会覆盖默认绑定逻辑，临时禁用它们再测试
最容易被忽略的是：第一次点击右下角选 Pug 后，必须再点一次、执行 Open all with current extension as… —— 少这一步，所有配置都只是临时的，关掉文件就失效。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
