0

0

EJS 模板变量渲染指南:解决 不显示输出的问题

霞舞

霞舞

发布时间:2025-09-21 10:14:18

|

1014人浏览过

|

来源于php中文网

原创

EJS 模板变量渲染指南:解决 <% %> 不显示输出的问题
不显示输出的问题 " />

本文旨在解决 EJS 模板中变量不正确渲染的问题,特别是当使用 标签尝试显示变量值时,却发现变量名原样输出而非实际内容。核心在于区分 EJS 模板中不同标签的功能: 用于控制流,而 才是用于安全地输出变量内容。通过详细解释和示例代码,本文将指导开发者正确使用 EJS 标签,确保模板变量能够被预期地解析和渲染。

EJS 模板标签解析

ejs (embedded javascript) 是一种流行的模板引擎,它允许在 html 模板中嵌入 javascript 代码,从而实现动态内容的生成。理解 ejs 提供的不同标签是正确使用它的关键。ejs 主要有以下几种标签类型:

  • (Scriptlet Tag): 此标签用于执行 JavaScript 代码,但不直接输出结果到 HTML。它通常用于控制流,例如 if/else 语句、for 循环、变量声明等。 示例:

    <% if (user.loggedIn) { %>
        

    欢迎 <%= user.name %>

    <% } else { %>

    请登录

    <% } %>
  • (Output Tag, Escaped): 此标签用于将 JavaScript 表达式的结果输出到 HTML。它会自动对输出内容进行 HTML 转义(例如,将 示例:

    页面标题:<%= pageTitle %>

  • (Output Tag, Unescaped): 此标签也用于输出 JavaScript 表达式的结果,但它不会对内容进行 HTML 转义。这意味着如果变量中包含 HTML 标签,它们将作为原始 HTML 被渲染。使用此标签时需要格外小心,因为它可能引入 XSS 漏洞。仅在您确定内容是安全的情况下使用。 示例:

    <%- rawHtmlContent %>
  • (Comment Tag): 此标签用于在 EJS 模板中添加注释。注释内容不会被渲染到最终的 HTML 输出中。 示例:

    <%# 这是一个 EJS 模板注释,不会出现在浏览器中 %>

常见问题:变量不渲染的原因

许多初学者在使用 EJS 时,会遇到一个常见问题:尝试显示变量 KindOfDay 的值,但在浏览器中却看到

Its a

这样的原始输出,而不是期望的 "Its a Weekend" 或 "Its a Weekday"。

问题根源: 这通常是因为错误地使用了 Scriptlet Tag () 来尝试输出变量。如上所述, 标签仅用于执行代码逻辑,而不负责将表达式的结果渲染到 HTML。当 EJS 引擎遇到 时,它会将其视为一段需要执行的 JavaScript 代码,但由于 KindOfDay 只是一个变量名,没有明确的执行操作(如 console.log() 或赋值),它不会产生任何输出,最终导致原始标签内容被保留。

解决方案:使用正确的输出标签

要正确地将变量 KindOfDay 的值渲染到 HTML 中,必须使用 输出标签

错误示例 (不渲染变量):


    

Its a <%KindOfDay%>

正确示例 (渲染变量):


    

Its a <%= KindOfDay %>

通过将 修改为 ,EJS 引擎将识别这是一个需要输出的表达式,并将其值(例如 "Weekend" 或 "Weekday")安全地插入到 HTML 中。

完整示例与实践

下面是一个结合 Express.js 和 EJS 的完整示例,演示如何正确设置 EJS 模板引擎并渲染动态内容:

码上飞
码上飞

码上飞(CodeFlying) 是一款AI自动化开发平台,通过自然语言描述即可自动生成完整应用程序。

下载

1. 项目结构:

my-express-app/
├── app.js
└── views/
    └── list.ejs

2. app.js (Express 应用):

const express = require("express");
const bodyParser = require("body-parser");
const path = require("path"); // 引入 path 模块

const app = express();

// 设置 EJS 为视图引擎
app.set('view engine', 'ejs');
// 设置视图文件目录
app.set('views', path.join(__dirname, 'views'));

// 使用 body-parser 中间件(如果需要处理 POST 请求)
app.use(bodyParser.urlencoded({ extended: true }));
app.use(express.static("public")); // 如果有静态文件(如CSS/JS),需要设置静态文件目录

app.get("/", (req, res) => {
    var today = new Date();
    // 使用 getDay() 获取星期几(0-6,0为周日,6为周六)
    var dayOfWeek = today.getDay();
    var day = "";

    if (dayOfWeek === 0 || dayOfWeek === 6) { // 周日或周六
        day = "Weekend";
    } else {
        day = "Weekday";
    }

    // 渲染 list.ejs 模板,并传入 KindOfDay 变量
    res.render("list", { KindOfDay: day });
    console.log(`当前计算出的日期类型: ${day}`);
});

const port = 3000;
app.listen(port, () => {
    console.log(`Server Running on port ${port}`);
});

注意: 在 app.js 中,我们修正了获取星期几的逻辑,使用 today.getDay() 代替 today.getDate(),因为 getDate() 返回的是月份中的日期,而不是星期几。

3. views/list.ejs (EJS 模板):




    
    
    EJS 动态内容


    

今天是 <%= KindOfDay %>

运行步骤:

  1. 确保已安装必要的依赖:
    npm init -y
    npm install express ejs body-parser
  2. 将上述 app.js 和 views/list.ejs 文件保存到对应的位置。
  3. 在终端中运行 app.js:
    node app.js
  4. 在浏览器中访问 http://localhost:3000。您将看到页面显示 "今天是 Weekend" 或 "今天是 Weekday",具体取决于当前是周末还是工作日。

注意事项与总结

  • 区分标签功能: 始终牢记 用于逻辑控制, 用于输出转义后的内容, 用于输出未转义的原始内容。
  • 安全实践: 除非您完全信任要输出的内容来源,否则应优先使用 来输出变量,以避免潜在的 XSS 攻击。
  • VS Code 扩展: 虽然 EJS 渲染问题与 VS Code 本身无关,但安装 EJS 相关的 VS Code 扩展(如 "EJS language support")可以提供语法高亮、代码片段和智能提示,极大地提升开发体验。
  • 调试: 如果遇到变量未按预期渲染的问题,首先检查 EJS 标签是否正确,其次检查 Express 路由中 res.render() 函数是否正确传递了数据对象,以及数据对象中的键名是否与 EJS 模板中使用的变量名一致。

通过掌握 EJS 模板标签的正确用法,开发者可以高效且安全地构建动态 Web 页面。理解 Scriptlet Tag 和 Output Tag 的核心区别是解决大多数 EJS 渲染问题的关键。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

778

2023.08.22

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

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

514

2023.06.20

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

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

244

2023.07.28

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

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

298

2023.08.03

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

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

5306

2023.08.17

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

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

481

2023.09.01

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

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

212

2023.09.04

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

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

218

2023.09.14

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

158

2026.01.28

热门下载

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

精品课程

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

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 24.7万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号