VSCode无法直接运行EJS文件，因其需Node.js服务端渲染；应使用express+ejs搭建本地服务，配合插件提升开发体验但不参与渲染。
VSCode 里直接运行 ejs 文件会报错：没有 Node.js 环境
VSCode 本身不执行 EJS，它只是编辑器。你双击 index.ejs 或右键“Open with Live Server”，浏览器只会原样显示源码（甚至可能提示下载），因为 EJS 是服务端模板，必须经 ejs.render() 或 ejs.renderFile() 解析成 HTML 才能被浏览器识别。
常见错误现象：
- Live Server 打开
.ejs文件 → 浏览器显示乱码或原始标签（如<% if (user) { %>） -
node index.ejs报错Cannot use import statement outside a module或ReferenceError: require is not defined
正确做法是写一个最小 Node.js 脚本启动本地服务，用 ejs 包渲染模板：
const ejs = require('ejs');
const http = require('http');
const fs = require('fs');
http.createServer((req, res) => {
if (req.url === '/') {
const html = ejs.render(fs.readFileSync('./index.ejs', 'utf8'), { title: 'Hello EJS' });
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end(html);
}
}).listen(3000);
console.log('Server running at http://localhost:3000/');
用 express + ejs 配置真实可用的预览环境
单纯用 http 模块太简陋，不支持静态资源（CSS/JS）、路由、热重载。推荐用 express，它和 ejs 原生兼容，配置清晰：
立即学习“前端免费学习笔记（深入）”；
- 安装依赖：
npm init -y && npm install express ejs - 新建
app.js，设置模板引擎路径：app.set('views', './views')和app.set('view engine', 'ejs') - 确保
views目录下有index.ejs，且文件名与res.render('index')中一致 - 静态资源放
public目录，用app.use(express.static('public'))挂载
关键点：EJS 默认不启用 .ejs 后缀自动补全，res.render('index') 会找 views/index.ejs，不是 index.html.ejs —— 文件命名必须严格匹配。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
VSCode 插件不能替代运行时，但能提升开发体验
插件如 EJS language support（by DigitalBrain79）只提供语法高亮、代码片段和简单跳转，**不参与渲染**。别指望它让右键“Preview”生效。
真正有用的组合是：
-
ES7+ React/Redux/React-Native snippets→ 可自定义 EJS 快捷片段（比如输入ejst展开为<% if (<cursor>) { %><% } %></cursor>） -
Auto Rename Tag→ 同步修改 EJS 中的 HTML 标签（如<div><% users.forEach(...) %></div>） -
Live Server仍可用来托管public下的静态资源，但不要直接打开.ejs文件
注意：emeraldwalk.runonsave 可配置保存时自动运行 node app.js，但需配合 nodemon 避免手动重启 —— 否则改完模板还得 Ctrl+C 再 node app.js。
ejs.render() 和 ejs.renderFile() 的参数差异影响调试效率
开发阶段频繁修改模板，用 renderFile 更安全；调试数据结构时用 render 更灵活。二者核心区别在路径处理和错误堆栈：
-
ejs.renderFile('./views/page.ejs', data, { async: false })：路径是相对当前工作目录（process.cwd()），出错时堆栈含具体行号，适合正式调试 -
ejs.render(str, data)：传入字符串，无路径信息，错误只报“SyntaxError in template”，难定位 —— 除非你用filename选项显式注入：{ filename: 'page.ejs' } - 默认关闭缓存（
cache: false），但生产环境务必设为true，否则每次请求都读文件，性能暴跌
容易被忽略的是 rmWhitespace 选项：设为 true 会删空格换行，导致 CSS 排版错乱（比如 inline-block 元素间的空白符），调试时建议保持默认 false。
