跳到正文
每周二、五更新 · 排障记录与可运行代码邮件订阅:hi@xiaoming1.cn
编程心得标志,字母 A 与代码尖括号组合编程心得Awesome Dev

Deno 2.0 兼容 npm:一个 6 万行 Node 项目的迁移记录

昏暗房间里多块屏幕显示代码与运行状态
昏暗房间里多块屏幕显示代码与运行状态。配图为免费图库实拍,与本文主题对应。

2024 年 10 月 9 日,Deno Land 发布 Deno 2.0。新版本把 npm 兼容做成主线,package.json、node_modules 和 npm: 说明符都能直接用,同时提供 LTS 分支。

事实核对
  • 发布机构:Deno Land,发布时间 2024 年 10 月 9 日
  • 版本信息:Deno 2.0,提供 LTS 分支
  • 迁移样本:62,431 行代码、214 个文件

为什么拿这个项目试

项目是一个内部订单工具,62,431 行、214 个文件,依赖 41 个 npm 包,没有原生模块。选它是因为边界清楚:只提供 HTTP 接口和定时任务,不碰图像处理,也不依赖 node-gyp。

迁移花了 3 个工作日。第一天跑 deno install 和测试,第二天修 7 个失败,第三天做压测和回滚演练。真正改代码的时间不到 6 小时,其余时间在确认依赖行为和部署脚本。

7 次失败分别是什么

4 次是 node: 内置模块的差异,主要集中在 fs 的回调式 API 和 path 的 Windows 分隔符。2 次是依赖包读取 __dirname 找模板文件,Deno 下需要改成 import.meta.dirname。1 次是定时任务用了 setInterval 的 Node 特有参数。

没有一次失败与 TypeScript 类型相关,Deno 内置的类型检查直接通过了 214 个文件。这与项目本身类型写得较严有关,类型松的项目迁移时会在 deno check 阶段暴露更多问题。

启动与压测数据

同一台 4 核 8 GB 的机器,Node 22.12 冷启动 1.9 秒,Deno 2.0 冷启动 1.4 秒。预热后差距缩小到 0.2 秒,说明收益主要在模块加载和类型剥离阶段。

HTTP 压测用 1,000 并发、持续 3 分钟,Node 版 P99 28 毫秒,Deno 版 31 毫秒,慢了 10.7%。QPS 从 1,420 降到 1,360,差距在可接受范围,但如果接口对延迟极敏感,要先测再切。

哪些项目不建议迁

依赖原生模块的项目不建议现在迁。node-gyp 编译的 .node 文件在 Deno 下不能直接加载,官方给的是逐步兼容,不是完整支持。图像处理、数据库驱动和加密库最容易碰到这个问题。

需要长期稳定支持的生产服务,先等 Deno 的 LTS 线跑满一个周期。2.0 提供 LTS 是好事,但生态的兼容矩阵还在补,半年后再评估,成本会比现在低。

文中提到的命令与数据来自公开版本说明和本站测试机。换环境后数值会变,先在小规模数据上复跑一遍,再动生产。

相关

读完可以接着看

两件与本文问题域直接相关的产品。

把下一次故障写成可复用的记录

每周二、五发一封邮件,只放当周的排障笔记、命令清单和一处容易踩错的细节。不发广告,随时可退。

hi@xiaoming1.cn

也可以直接打电话:0668-339 7712,工作日 09:30 至 18:00。