必须手动将.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 中写入类似这样的映射：
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档，供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图，还原页面结构与交互，强制套用固定文档模板，抽取跨页面共享规则，或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
{
"extensions": ["pug"],
"syntax": "Packages/Pug/Pug.sublime-syntax"
}
注意：syntax 字段值必须严格满足三点：以 Packages/ 开头、大小写完全匹配（Pug 不是 pug）、后缀必须是 .sublime-syntax（不能是 .tmLanguage）。
安装 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… —— 少这一步，所有配置都只是临时的，关掉文件就失效。
