需安装Pug扩展、配置Prettier及插件、设置语言模式并禁用冲突插件:1.安装DigitalBrain79的Pug扩展;2.全局安装Pretterr并配置为默认格式化工具;3.安装prettier-plugin-pug并在.prettierrc中声明;4.将文件语言模式设为Pug后手动格式化;5.禁用EJS等冲突模板插件。

如果您在 VSCode 中编辑 Pug(原 Jade)模板文件,但缺乏语法高亮、智能提示或自动格式化支持,则可能是由于缺少对应语言支持扩展或配置未生效。以下是实现 Pug 智能提示与格式化功能的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装官方推荐的 Pug 扩展
VSCode 本身不内置 Pug 语言支持,需通过扩展提供语法识别、代码补全及错误检查能力。该扩展由社区维护,兼容最新版 Pug 语法规范。
1、打开 VSCode,点击左侧活动栏中的扩展图标(或按快捷键 Ctrl+Shift+X)。
2、在搜索框中输入 Pug,找到名称为 Pug (Jade) Snippets 的扩展(作者:DigitalBrain79)。
3、点击“安装”按钮,等待扩展下载并启用。
4、重启 VSCode,新建一个 .pug 文件,确认语法高亮已生效。
二、配置 Prettier 实现自动格式化
Prettier 是主流的代码格式化工具,配合插件可对 Pug 文件执行缩进、换行、属性排序等标准化处理,确保团队协作中模板风格统一。
1、在终端中执行命令全局安装 Prettier:npm install -g prettier。
2、安装 VSCode 扩展 Prettier(作者:Esben Petersen)。
3、打开 VSCode 设置(Cmd+,),搜索 default formatter,在“Editor: Default Formatter”中选择 esbenp.prettier-vscode。
4、创建项目根目录下的 .prettierrc 文件,写入以下内容:
{ "tabWidth": 2, "useTabs": false, "semi": false, "singleQuote": true }
三、启用 Pug 特定格式化支持
Prettier 默认不支持 Pug,需额外安装专用解析器以启用完整格式化能力,否则保存时可能报错或无响应。
1、在项目目录中执行:npm install --save-dev prettier-plugin-pug。
2、修改项目根目录下的 .prettierrc,添加插件声明:
{ "plugins": ["prettier-plugin-pug"] }
3、在 VSCode 设置中搜索 pug,找到“Pug: Format On Save”,勾选启用。
四、手动触发格式化并验证效果
格式化功能需在正确语言模式下激活,VSCode 必须识别当前文件为 Pug 类型,否则快捷键将无效。
1、打开任意 .pug 文件,点击右下角语言标识(如显示“Plain Text”)。
2、在弹出菜单中选择 Pug,确保状态栏显示 Pug。
3、按下快捷键 Shift+Alt+F(Windows/Linux)或 Shift+Option+F(macOS)触发格式化。
4、观察缩进是否从空格转为 2 字符、布尔属性是否移除等号、标签闭合是否自动补全。
五、禁用冲突格式化插件
部分用户安装了多个模板引擎插件(如 EJS、Handlebars),其内置格式化逻辑可能覆盖 Pug 配置,导致保存后代码被错误重排。
1、打开 VSCode 扩展面板,搜索 EJS 或 Handlebars 相关扩展。
2、对非 Pug 项目中不需要的模板类扩展,点击“禁用”而非卸载。
3、在设置中搜索 format on save,确认仅 Pug 关联文件类型启用该选项。
4、打开命令面板(Cmd+Shift+P),输入 Format Document With...,选择 Configure Default Formatter For '.pug',指定为 Prettier。










