Node.js项目打包为可执行文件时entry.html未被包含的解决方法

问题根源 #

pkg不会自动打包项目中的静态资源（如HTML、图片等），必须显式声明需要包含的文件；同时打包后__dirname指向可执行文件运行时的临时解压目录，而非本地开发时的项目目录，但核心问题还是资源未被加入打包清单。

具体解决方案 #

方案1：通过package.json配置pkg的资产清单 #

在项目根目录的package.json中添加pkg字段，指定需要打包的静态资源：

{
  "name": "your-app-name",
  "version": "1.0.0",
  "pkg": {
    "assets": [
      "entry.html",
      "images/**/*"
    ]
  }
}

• entry.html：直接指定单个需要打包的文件
• images/**/*：用通配符表示打包images目录下所有文件及子目录

配置完成后，重新执行打包命令：

pkg app.js

方案2：优化代码路径逻辑（辅助适配） #

打包后pkg会将资源解压到临时目录，建议用path.join统一拼接路径，避免系统路径分隔符问题，同时修正静态目录配置的安全隐患：

const path = require('path');

// ... 其他原有代码

// 修正entry.html的路径拼接
app.get('/main',(req,res) => {
    const entryPath = path.join(__dirname, 'entry.html');
    res.sendFile(entryPath);
});

// 替换原有的app.use(express.static('/')); 避免指向系统根目录
app.use(express.static(__dirname));

方案3：命令行参数直接指定资产 #

如果不想修改package.json，可在打包时通过--assets参数直接声明：

pkg --assets "entry.html,images/**/*" app.js

内容的提问来源于stack exchange，提问作者MrB