使用 NCC 和 PKG 将 Node.js 项目打包为跨平台可执行文件
很多时候我们需要将 Node.js 应用分发给没有安装运行环境的用户，或者希望部署更轻量。利用 ncc 进行代码编译，再配合 pkg 生成二进制文件，是解决这一问题的成熟方案。下面分享具体的实战流程。
准备工作
首先确保本地已安装 Node.js 环境。初始化一个基础项目：
mkdir my-node-app
cd my-node-app
npm init -y
接着安装业务依赖，这里以 Express 为例：
npm install express
创建入口文件 index.js：
const express = require('express');
const app = express();
const port = 3000;
app.get('/', (req, res) => {
res.send('Hello World!');
});
app.listen(port, () => {
console.log(`App listening at http://localhost:${port}`);
});
安装构建工具
我们需要两个核心工具：@vercel/ncc 用于编译打包模块，pkg 用于生成可执行文件。建议全局安装以便调用：
npm install -g @vercel/ncc
npm install -g pkg
编译与打包流程
1. 使用 NCC 编译
NCC 会将你的入口文件及其依赖项合并成一个单文件。这步能减少后续打包的体积，并处理 CommonJS/ESM 兼容性问题。
ncc build index.js -m -o dist
参数说明：
-m: 开启源码映射（可选，生产环境通常关闭）-o dist: 输出目录
2. 使用 PKG 打包
拿到编译后的文件后，用 pkg 将其封装成对应操作系统的二进制文件。注意，pkg 默认会检测当前系统架构，如果需要多平台支持，通常需要分别在 Linux、macOS 和 Windows 环境下各跑一次，或者配置交叉编译。
pkg dist/index.js --targets node18-linux-x64,node18-win-x64,node18-macos-x64
*注：如果不指定 targets，生成的文件仅在当前系统可用。上述命令示例展示了如何一次性生成三个平台的版本，实际使用时请根据需求调整。
运行验证
打包完成后，在对应目录下即可直接运行，无需安装 Node.js：
# Linux / macOS
./my-node-app
# Windows
my-node-app.exe
注意事项
- 内存占用：生成的二进制文件体积较大，因为它内置了 V8 引擎和 Node.js 运行时。
- 调试困难：一旦打包成二进制，调试堆栈信息不如源码方便，建议保留源码备份。
- 动态加载：如果项目中有动态
require或import外部文件，pkg可能无法识别，需要额外配置pkg的 assets 字段。
这套流程基本覆盖了从开发到交付的标准路径，对于中小型工具类应用非常实用。
