VSCode运行EJS/Pug模板:前端渲染引擎的实时预览配置

千宇吖_7673

千宇吖_7673

2026-06-25

435人浏览

原创

live server 打开 .ejs 文件只显示源码是设计使然,因其仅为静态 http 服务,不执行 ejs.render();需用 express + ejs 搭建服务端渲染环境才能正确解析并展示 html。

vscode运行ejs/pug模板:前端渲染引擎的实时预览配置

Live Server 打开 .ejs 文件只显示源码,不是 bug 是设计

VS Code 本身不执行 EJS 或 Pug,它只是编辑器。Live Server 启动的是纯静态 HTTP 服务,不会调用 ejs.render() 或 pug.render() —— 所以浏览器看到的必然是原始模板代码,甚至可能触发下载。

常见错误现象:Cannot GET /、页面显示 原样、右键“Open with Live Server”后浏览器一片空白或弹出下载框。

  • 别试图让 Live Server 渲染模板:它不支持任何服务端逻辑,也不加载 Node.js 环境
  • Live Server 只适合托管 public/ 下已构建好的 HTML/CSS/JS,比如你用脚本把 index.ejs 渲染成 dist/index.html 后,再用 Live Server 打开 dist 目录
  • 若想边写边看效果,必须走真实服务端流程:Express + ejs 或 Express + pug,搭配 nodemon 实现文件变更自动重启

Express + EJS 的最小可运行配置(无多余依赖)

要让 index.ejs 在浏览器里真正渲染成 HTML,你得启动一个能执行 ejs.renderFile() 的服务。Express 是最轻量且与 EJS 原生兼容的选择。

关键点不是“装多少包”,而是目录结构和 app.set() 的顺序是否正确:

  • 项目根目录下建 views/ 文件夹,把 index.ejs 放进去(不能放在根目录或 src/ 下)
  • 在 app.js 中严格按顺序写:app.set('views', './views') → app.set('view engine', 'ejs') → app.set('view engine', 'html') 这行不要加,EJS 不需要它
  • res.render('index') 会自动找 views/index.ejs;写成 res.render('index.ejs') 会报错
  • 静态资源(CSS/JS)放 public/,用 app.use(express.static('public')) 挂载,路径是相对 public/ 的,比如 public/css/style.css 对应 /css/style.css

Pug 模板需额外配 prettier-plugin-pug 才能安全格式化

Pug 的缩进敏感性和混合语法(JavaScript + 模板指令)会让默认的 Prettier 直接崩溃或破坏结构。直接启用 Prettier 格式化 .pug 文件,大概率导致 unexpected token 或渲染失败。

Feishu calendar sync, local ics to json data for AI agent
Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式,用于飞书日历导入导出及数据集成。

下载

必须分三步走通格式化链路:

  • 安装 prettier-plugin-pug:运行 npm install --save-dev prettier-plugin-pug(注意是 --save-dev,不是全局)
  • 在项目根目录的 .prettierrc 中声明插件:{"plugins": ["prettier-plugin-pug"]}
  • VS Code 设置中指定 Prettier 为默认格式化工具,并确保当前文件语言模式是 Pug(右下角点击切换,不是 Plain Text 或 HTML)
  • 禁用其他模板类插件(如 EJS 相关扩展),它们会抢语言服务控制权,导致 Pug 补全失效

EJS 文件在 VS Code 里没高亮、没 Emmet 补全?先看语言模式

VS Code 默认把 .ejs 当作纯文本,所以 div.container+Tab 不展开、 没颜色、双击选不中标签对——这不是插件没装,是语言服务根本没激活。

修复只需两处 settings.json 配置,缺一不可:

  • "files.associations": { "*.ejs": "ejs" }:告诉 VS Code 用 EJS 语言服务处理所有 .ejs 文件
  • "emmet.includeLanguages": { "ejs": "html" }:让 Emmet 把 .ejs 当 HTML 解析,ul>li*3 才能展开
  • 必须安装 vscode-ejs-language-service(作者 DigitalBrainstem),旧版 “EJS Language Support” 已停更,不支持 VS Code 1.80+ 的语言服务器协议
  • 改完设置后按 Ctrl+Shift+P → 输入 Developer: Reload Window,否则右下角语言模式仍显示 Plain Text

复杂点在于:EJS 混合了 HTML 结构和 JS 逻辑,格式化器、校验器、补全引擎必须各司其职。ESLint 不能校验 .ejs,Prettier 必须桥接专用插件,Emmet 要手动绑定语言类型——少一步,整个开发流就断在编辑器里。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode js 前端

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4903

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5990

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5498

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

4016

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1255

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1618

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

9523

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程