文档›迁移

从 Node.js 迁移到 Deno

一条保留回滚能力、逐层验证兼容性的 Deno 2 迁移路线

查看 Markdown 上游来源

Deno 2 能读取 package.json、解析 npm 包并运行大量 Node API。迁移的正确起点不是重写 imports，而是证明现有应用在另一 runtime 下仍然满足测试与生产约束。

四段路线

1. 建立兼容基线固定版本，保留现有安装方式，先运行无副作用脚本与测试。2. 对齐包与配置理解 package.json、deno.json、lockfile 和 node_modules 模式。3. 逐个替换 API保留可工作的 node: API，只在有收益时采用 Web/Deno API。4. 清理兼容问题处理 CommonJS、原生扩展、install scripts、权限和测试差异。

每阶段验收

deno install
deno check src/main.ts
deno test
deno task start

在 CI、开发机和目标生产环境都通过之前，不删除旧 lockfile、旧 runtime 命令或部署路径。一次提交只改变运行时、包管理、测试、框架或部署中的一层。

官方参考：Migrate to Deno、Node and npm compatibility。