如何将EJS模板文件打包进Node.js可执行文件

云原生阿岚

2026-6-21

解决pkg打包Express+EJS应用时视图文件缺失的问题

核心原因

pkg默认仅打包.js/.json等Node.js可识别的模块文件，EJS模板这类静态文件不会被自动包含，导致运行时找不到指定的视图目录。

解决方案

方法一：通过package.json配置pkg打包资源

这是最简便的处理方式，直接告知pkg需要打包的EJS文件：

在项目根目录的package.json中添加pkg配置项，指定要包含的视图文件路径：

{
  "pkg": {
    "assets": ["view/**/*.ejs"]
  }
}

view/**/*.ejs表示打包view目录下所有子目录中的.ejs文件，可根据项目实际目录结构调整匹配规则。

保持原Express视图配置不变即可。pkg运行时会将打包的资源放到snapshot临时目录，原代码的path.join(__dirname, 'view')会自动指向该目录下的视图文件夹，无需额外修改路径逻辑。

方法二：手动读取EJS模板并渲染

若不想修改package.json，可通过代码直接读取模板文件并完成渲染：

确保已安装EJS依赖：npm install ejs
修改路由代码，替换res.render为手动读取渲染逻辑：

const express = require('express');
const ejs = require('ejs');
const fs = require('fs');
const path = require('path');
const app = express();

app.get('/', (req, res) => {
  // 拼接模板文件的完整路径
  const templatePath = path.join(__dirname, 'view', 'myfile.ejs');
  // 同步读取模板文件内容
  const templateContent = fs.readFileSync(templatePath, 'utf8');
  // 渲染模板（第二个参数为模板所需的变量数据）
  const renderedHtml = ejs.render(templateContent, { /* 你的数据对象 */ });
  // 返回渲染后的HTML内容
  res.send(renderedHtml);
});