讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在VSCode中基于Node环境使用EJS快速开发静态模板

阿伟大大_4069

阿伟大大_4069

发布时间:2026-07-07 09:44:56

|

121人浏览过

|

来源于php中文网

原创

VSCode 无法直接运行 EJS,必须通过 Node.js 调用 ejs.render() 或 ejs.renderFile() 才能将 .ejs 文件渲染为 HTML;Live Server 仅支持静态文件,不解析 EJS,故打开 .ejs 会显示源码或下载;正确做法是用 Express + EJS 搭建本地服务,配合 nodemon 实现热重载预览。

如何在vscode中基于node环境使用ejs快速开发静态模板

VSCode 本身不运行 EJS,它只是编辑器;真正让 .ejs 文件变成 HTML 的,必须是 Node.js 运行时调用 ejs.render() 或 ejs.renderFile()。所谓“快速开发静态模板”,本质是搭建一个轻量、可热重载、能即时预览的本地服务环境——不是靠插件点一下就渲染,而是靠 Express + EJS 组合实现闭环。

为什么 Live Server 打开 .ejs 文件只会显示源码或下载?

Live Server 是为纯静态文件(.html、.css、.js)设计的 HTTP 服务器,它不识别 .ejs 后缀,也不会调用 EJS 解析引擎。浏览器收到未渲染的 .ejs 内容时,要么当成文本显示(含 标签),要么因 MIME 类型不匹配触发下载。

  • 错误现象:http://127.0.0.1:5500/index.ejs → 浏览器地址栏正常,但页面显示原始 EJS 源码
  • 根本原因:没有 Node.js 进程执行 ejs.renderFile('./index.ejs', data)
  • 误区纠正:任何 VSCode 插件(包括 EJS language support)都**不能替代运行时渲染**,它们只负责语法高亮和跳转

用 Express + EJS 搭建最小可用预览服务

这不是“配置”,而是写一个真实可运行的脚本。Express 原生支持 EJS,且默认约定清晰,比手动用 http 模块更可靠、更易扩展。

  • 初始化项目:npm init -y && npm install express ejs
  • 目录结构必须包含:views/(放 index.ejs)、public/(放 CSS/JS/图片)
  • app.js 关键配置三行:
app.set('views', './views');
app.set('view engine', 'ejs');
app.use(express.static('public'));

注意:res.render('index') 会自动查找 ./views/index.ejs,不是 index.html.ejs,文件名必须严格匹配,后缀不可省略。

Comprehensive Three.js 3D graphics reference
Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

如何让修改 EJS 后自动刷新浏览器?

Express 本身不带热重载,但加一个轻量工具就能解决。推荐 nodemon,它监听文件变化并重启服务,配合 Live Server 托管 public/ 下资源,体验接近前端开发流。

  • 安装:npm install --save-dev nodemon
  • 改 package.json 中的 "scripts":
"dev": "nodemon app.js"

启动后访问 http://localhost:3000/,每次保存 views/index.ejs,nodemon 会重启服务,浏览器刷新即可看到新结果。

  • 别把 Live Server 用在 .ejs 上——它只该用于 public/ 下的静态资源调试(比如单独打开 public/style.css)
  • 如果用了 res.sendFile() 直接返回 .ejs 文件,那还是原始内容——必须走 res.render()

EJS 文件命名与路径容易踩的坑

EJS 渲染对路径和命名极其敏感,错一个字符就 404 或报 Error: Failed to lookup view。

  • app.set('views', './templates') → 那么所有 res.render('home') 就必须对应 ./templates/home.ejs,不是 ./views/home.ejs
  • 子目录需显式写出:res.render('admin/dashboard') 查找的是 ./views/admin/dashboard.ejs
  • 不支持自动补 .ejs 后缀:写 res.render('index.html') 就真去找 index.html,不会 fallback 到 index.html.ejs
  • 变量传入必须是对象:res.render('index', { title: 'My Site' }),不能传数组或原始值

最常被忽略的是:EJS 模板里写的 include 路径,是相对于 views 目录的,不是相对于当前文件——比如 总是去 ./views/partials/header.ejs,哪怕当前模板在 ./views/user/profile.ejs。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
js正则表达式
js正则表达式

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

3876

2023.06.20

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

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

1235

2023.07.28

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

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

1578

2023.08.03

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

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

9343

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

860

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2304

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

1449

2023.09.14

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

3889

2023.09.21

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

0

2026.09.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn