装了Pug插件但.pug文件仍显示Plain Text，是因为Sublime未自动绑定扩展名与语法；需手动两次点击右下角语法标识：先选Pug，再选“Open all with current extension as…→Pug”，以写入用户配置映射规则。
装了 Pug 插件但 .pug 文件右下角还是显示 Plain Text，说明语法没绑定成功——这不是插件没装好，而是 Sublime 没把扩展名和语法定义关联起来。
为什么安装 Pug 包后仍不生效
Package Control 安装的 Pug 包只提供 Pug.sublime-syntax 文件，不会自动注册 .pug 后缀。常见错误现象包括：
- 打开
index.pug，右下角显示Plain Text或HTML - 即使重启 Sublime，高亮也不出现
- 手动选右下角菜单里的
Pug选项，但下次打开又变回Plain Text
根本原因是：Sublime 的文件关联规则没写入用户配置，必须显式触发一次“永久绑定”。
正确绑定 .pug 后缀的两步操作
打开任意一个 .pug 文件后，按顺序执行：
立即学习“前端免费学习笔记（深入）”；
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 点击窗口右下角当前语法标识（如
Plain Text）→ 在弹出菜单中选择Pug（如果没这个选项，说明插件未加载，需重启或重装） - 再次点击右下角 → 选择
Open all with current extension as…→ 再次选Pug
这一步会自动往 Packages/User/Preferences.sublime-settings 里写入一条映射规则。检查该文件，确认含以下字段：
"syntax": "Packages/Pug/Pug.sublime-syntax"
注意三处细节：Packages/ 前缀不能少、Pug 大小写必须一致、后缀必须是 .sublime-syntax（不是 .tmLanguage）。
Pug 语法包与 Jade 的兼容性问题
2026 年主流维护的是 Pug 包，不是旧版 Jade。搜索时优先输 Pug；若搜不到，再试 Jade，但要注意：
- 旧
Jade插件用的是source.jadescope，而新Pug用source.pug - 如果你的主题配色方案只定义了
source.jade的颜色，那装了Pug包也看不到高亮 - 可通过
Ctrl+Shift+P→ 输入Developer: Show Scope Name查看当前光标所在位置的实际 scope
配合 CLI 实现保存即编译（可选增强）
仅靠语法高亮无法预览 HTML 效果，建议搭配 pug-cli 实现即时编译：
- 全局安装：
npm install pug-cli -g - 监听编译：
pug -w -o ./dist/ ./src/（监听./src/下所有.pug文件，输出到./dist/） - 加
--pretty参数让生成的 HTML 可读性更强：pug --pretty -o ./dist/ index.pug
真正容易被忽略的是：scope 名称和主题配色的匹配关系——它不报错，但高亮就是不出现，得靠 Show Scope Name 去验证，而不是反复重装插件。
