使用ejs-mate时layout路径报错：文件或目录不存在

问题根因 #

你遇到的报错是因为ejs-mate默认以当前模板文件所在目录为基准解析布局路径。你的模板文件位于views/listings/目录下，当你调用<% layout("layouts/boilerplate") %>时，它会尝试在views/listings/layouts/下查找文件，而非你预期的views/layouts/目录。

解决方案 #

1. 使用绝对路径指定布局 #

在布局路径前添加/，强制从views根目录开始解析：

<% layout("/layouts/boilerplate") %>

这样ejs-mate会直接去views/layouts/boilerplate.ejs查找布局文件，符合你的预期。

2. 配置全局默认布局（可选） #

如果大部分模板都使用同一个布局，可以在注册ejsMate引擎时设置全局默认布局，避免每个模板都写layout()调用：

const path = require('path');
const ejsMate = require('ejs-mate');
const express = require('express');
const app = express();

// 注册ejsMate引擎并设置全局布局
app.engine('ejs', ejsMate({
  layout: 'layouts/boilerplate' // 路径相对于views根目录
}));
app.set('view engine', 'ejs');
app.set('views', path.join(__dirname, 'views')); // 确保views根目录配置正确

3. 确认视图根目录配置 #

检查你的app.set('views', ...)配置，确保它指向项目根目录下的views文件夹，而非子目录。使用path.join可以避免Windows系统下的路径分隔符问题。

验证步骤 #

• 确认views/layouts/boilerplate.ejs文件确实存在
• 重启服务后重新测试，避免缓存导致的问题

内容的提问来源于stack exchange，提问作者Ijaz Ahmad Afridi