Node.js 新特性 SEA/单文件可执行应用尝鲜

#1 关于 SEA

单文件可执行应用(SEA,Singe Executable Applications),是 Node.js 新版本的特性,最初在 v19.7.0、v18.16.0 加入,并在 v20.x 得到扩展。而上个月发布的全家桶 Bun.js,就自带了 SEA 功能🙃。

此前,若需要把 JS 文件打包,通常会选择下面几种工具:

名称 最新版本 最新发布 说明
pkg 5.8.1 2023-03-08 Package your Node.js project into an executable
boxednode 2.1.2 2023-09-27 Ship a JS file with Node.js in a box
nexe V3 2017-08-30 create a single executable out of your node.js apps
node-sea 0.3.0 2022-09-22 Pack entire packages and application into portable scripts

#2 实战 SEA

#2.1 尝鲜官方 SEA

开始前请先升级到 node v20+,否则后续的命令会报错:bad option --experimental-sea-config

首先我们写一个简单的脚本,实现在控制台用边框包裹参数文本的功能。

javascript 复制代码
/**
 * @type {String}
 */
let name = process.argv[2]
if(!name || name.trim().length == 0){
    console.error("ERROR: 请输入名字")
    process.exit(-1)
}

console.log(`Hello, ${name}`)

接下来编辑 sea-config.json 文件,内容是

json 复制代码
{
    "main": "index.js",
    "output": "index.blob"
}

执行命令node --experimental-sea-config sea-config.json后生成index.blob文件(可以用文本编辑器查看,其实就是之前的代码前加了一小段内容🙂)

接着执行:

shell 复制代码
# 将 node 环境包装成 exe 可执行文件(大小约为 68M)
node -e "require('fs').copyFileSync(process.execPath, 'hello.exe')" 
# 此时运行 ./hello.exe 与执行 node 命令效果一致😂

# 接下来就是把 blob 文件转载到 hello.exe 内
npx postject hello.exe NODE_SEA_BLOB index.blob --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2 --overwrite
# 首次执行时,会提示安装 postject 包;增加 --overwrite 强制覆盖

运行效果

#2.2 PKG方案

shell 复制代码
# 请先安装 pkg:npm install -g pkg

# 执行打包
pkg -t node16-win-x64 index.js -o hello-pkg.exe
# 大概 2 秒即可完成,生成 34M 大小的可执行文件
# 注意:按照官方文档,目前 pkg 最新支持到 node19 的打包,详见 https://github.com/vercel/pkg-fetch/blob/main/patches/patches.json

#2.3 存在的问题

SEA 本质就是把 node 环境与我们自己的 JS 文件一同打包,所以得到的产物体积都偏大。实际情况下,个人首选 pkg。

另外,官方及 pkg 都只支持单文件打包,若存在第三方库、文件的依赖,在运行时就会报 module 找不到的异常。

此时,可以使用诸如 webpack、vite 等构建工具把项目编译成单文件,再进行 SEA 包装😄。

相关推荐
用户2160763408313 小时前
一个 2 MB 的 .zst 文件,解压出来只有十几 KB
node.js
木头左2 天前
【浏览器自动化】用 CDP 接管本机 Chrome:从一个宿主迁到另一个宿主的设计与踩坑
node.js·浏览器自动化·cdp·技能化·踩坑实践
cpolar技术支持2 天前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
SEO_juper3 天前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
木头左4 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能4 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
w3296362716 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔6 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs
匠云创新6 天前
读完一万段要两分钟:我们把标书读取从 WPS 对象模型搬到了 docx 解析
性能优化·node.js
某哈压力大7 天前
SSH 突然 Connection reset?不是密钥坏了,是 OpenSSL 把 sshd 干趴了
前端·node.js·命令行