Node Runtime

utoo 可以在 ut install 时一并安装 Node.js 二进制，让项目不再依赖系统上装好的 Node。在 package.json 中声明 engines.install-node 即可启用。

用法

{
  "engines": {
    "install-node": "20"
  }
}

支持任意 npm 能识别的版本范围："20"、"20.11.1"、"^20.0.0"。执行 ut install 后，匹配范围的 Node 二进制会被安装到 node_modules 中，package.json 脚本可直接使用。

平台展开

utoo 会把 engines.install-node 展开成 6 个平台对应的 optionalDependencies 条目：

由于它们是 optionalDependencies，按 npm 的标准行为，只有与当前 os / cpu 匹配的包会真正被安装。

install-node 与 engines.node 的区别

两者解决不同的问题：

两者可以组合：用 engines.node 声明兼容性契约，用 engines.install-node 保证实际安装到的版本满足它。

{
  "engines": {
    "node": ">=20.0.0",
    "install-node": "20.11.1"
  }
}

使用场景

• 无需额外”安装 Node”步骤的 CI：一条 ut install 就够，不需要 setup-node / nvm install。
• 团队版本一致性：锁定 install-node 让所有开发者、所有机器用同一个 Node，与 nvm / fnm / 系统装的版本无关。
• 从 utoo 一路引导：utoo 的安装脚本（curl … | bash）本身不依赖已装 Node——配合 install-node，一台全新机器只要两条命令就能完成”装 utoo → 装项目 + Node”。