Sublime Text中.pug文件语法高亮需先手动选择Pug语法再执行“Open all with current extension as…”，否则右下角始终显示Plain Text；配置中syntax字段必须严格为"Packages/Pug/Pug.sublime-syntax"，大小写、前缀和后缀缺一不可。
Sublime Text 默认打不开 .pug 文件的语法高亮，不是插件没装对，而是扩展名根本没绑定到 Pug 语法——哪怕你已安装了 Pug 包，右下角仍显示 Plain Text，这是最常见、也最容易卡住人的一步。
为什么装了 Pug 插件右下角还是 Plain Text
根本原因：Package Control 安装的只是语法定义文件（Pug.sublime-syntax），它不自动注册 .pug 后缀。Sublime 不会“猜”你想要什么语言，必须手动告诉它。
- 打开任意一个
index.pug文件，右下角显示Plain Text→ 点击它 - 若弹出菜单里没有
Pug，说明插件未加载成功：重启 Sublime，或重装 Pug 包（别选 Jade，2026 年主流维护的是Pug包） - 如果看到
Pug，先点一下 → 再次点击右下角语言名 → 选Open all with current extension as…→ 确认选中Pug - 这步会写入用户配置：
"extensions": ["pug"], "syntax": "Packages/Pug/Pug.sublime-syntax"——注意大小写、Packages/前缀、.sublime-syntax后缀三者必须完全匹配
如何确认 syntax 配置是否生效
直接检查 Packages/User/Preferences.sublime-settings 文件内容，重点看是否有这段映射：
"extensions": [ "pug" ], "syntax": "Packages/Pug/Pug.sublime-syntax"
常见错误包括：
前端设计优化skill
下载
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“前端免费学习笔记（深入）”；
- 写成
"syntax": "Pug/Pug.sublime-syntax"（漏了Packages/） - 写成
"syntax": "Packages/pug/Pug.sublime-syntax"（pug小写） - 写成
"syntax": "Packages/Pug/Pug.tmLanguage"（旧格式，新包只用.sublime-syntax） - 多个扩展名共用同一段配置时，
"extensions"数组里混入了"jade"，但当前插件不支持该 scope
安装 Pug 语法包的推荐路径（别走手动复制老路）
2026 年所有主流 Sublime 版本（ST4 及 ST3 最新版）都应优先使用 Package Control，避免 YAML 结构错位或 scope 冲突：
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Install Package回车 → 等待列表加载完成 - 搜
Pug，选中并安装（作者通常是hdefuany或sublimelsp维护的活跃分支） - 安装完无需重启，直接打开
.pug文件测试；若仍不生效，再执行上一节的绑定操作 - 不推荐手动下载
jade.tmbundle或复制.tmLanguage文件：这些是 Sublime Text 2 时代的遗留方案，ST4 已不兼容其 scope 声明方式
真正容易被忽略的是：绑定操作必须在「已加载 Pug 语法」的前提下进行——也就是说，右下角菜单里得先能看到 Pug 这个选项。很多人卡在第一步就去改配置文件，结果越改越乱。先让 Sublime 认出这个语法，再让它记住后缀，顺序不能颠倒。
