Node.js v25.5.0 更新速览

前言

Node.js v25.5.0 无重大破坏性变化，主要聚焦 SEA 打包体验提升、API 增强、bug 修复和依赖更新。下面详细拆解核心亮点。

往期精彩推荐

• Nuxt 4.3 版本发布了！
• VS Code 1.106 版本新功能速览
• Node.js 存在多个严重安全漏洞！官方建议尽快升级
• 更多精彩文章欢迎关注我的公众号

正文

1. SEA（Single Executable Applications）构建革命性简化

• 新增 --build-sea CLI 命令（最大亮点）

以前打包 SEA 需要多步操作：写 config → postject 注入 blob → 复制可执行文件。

现在只需一条命令搞定！示例：

echo 'console.log("Hello from SEA")' > hello.js
echo '{ "main": "hello.js", "output": "sea" }' > sea-config.json
node --build-sea sea-config.json
./sea   # 直接运行输出 Hello from SEA

向后兼容旧流程（--experimental-sea-config + postject），但官方强烈推荐迁移到新方式，未来旧方法可能逐步移除。

内部实现上：引入 LIEF 库作为新依赖，用于二进制操纵；SEA 相关代码拆分重构，提升可维护性。测试也全部迁移到新命令和 fixture 目录。

2. 其他 API 与模块增强（SEMVER-MINOR）

• fs.watch 新增 ignore 选项：可过滤掉不想监听的事件，提升文件监视效率。
• test_runner 支持 expect test to fail：允许编写“预期会失败”的测试用例，便于验证错误处理逻辑。
• sqlite 模块：
  • prepare 语句支持传入选项参数。
  • defensive mode 默认开启，进一步提升数据库操作安全性。
• 线程命名统一前缀：所有 worker 线程名现在以 node- 开头，更易在进程列表中识别。
• QUIC 支持移到编译时标志：默认关闭，需要显式编译开启（对大多数用户影响小，但 QUIC 开发者需注意）。

3. 依赖与安全更新

• npm 升级到 v11.8.0。
• V8：cherry-pick 和 backport 若干修复，total_allocated_bytes 调整避免 ABI 破坏。
• sqlite 更新到 v3.51.2。
• ICU 更新到 v78.2。
• ada（URL 解析）到 v3.4.0。
• zlib 到 v1.3.1（特定 commit）。
• crypto：根证书更新到 NSS 3.119，修复潜在信任链问题。
• 新增依赖：LIEF（用于 SEA 二进制处理）。

本次发布无 CVE 安全修复（非 security release），但证书更新和 QUIC 调整仍值得关注。

升级建议：

• SEA 用户优先迁移到 --build-sea。
• 运行 nvm install 25.5.0 或官网下载最新二进制。
• 生产环境测试后升级，关注 QUIC 和线程名变化对监控的影响。

最后

Node.js v25.5.0 通过 --build-sea 大幅降低了 SEA 打包门槛，让 Node.js 更接近“开箱即用”的原生可执行体验；

同时 API 增强和依赖更新保持了 Current 通道的活力。本

次更新虽不算大爆炸，但实用性拉满，未来 SEA 生态会越来越香。

今天的分享就这些了，感谢大家的阅读，如果文章中存在错误的地方欢迎指正！

往期精彩推荐

• Nuxt 4.3 版本发布了！
• VS Code 1.106 版本新功能速览
• Node.js 存在多个严重安全漏洞！官方建议尽快升级
• 更多精彩文章欢迎关注我的公众号