使用 pnpm 管理 node 运行环境

基本用法#

使用 pnpm runtime set 命令可以方便地安装各种版本：

1
pnpm runtime set <name> <version> [-g]

支持的运行时包括：

• ​node - Node.js
• ​deno - Deno
• ​bun - Bun

例如：

1
# 安装最新的 Node.js v22 长期支持（LTS）版本
2
pnpm runtime set node lts -g
3

4
# 安装最新版本
5
pnpm runtime set node latest -g
6

7
# 安装指定版本号
8
pnpm runtime set node 22.11.0 -g
9

10
# 安装预发布版 (Release Candidate)
11
pnpm runtime set node rc -g
12

13
# 通过代号安装，例如 Node.js 4.x 的代号 'argon'
14
pnpm runtime set node argon -g

​重要提示​：自 v11 起，通过 pnpm runtime​ 安装的 Node.js 将不再包含捆绑的 npm​、npx​ 和 corepack​。这可以显著减少安装时的文件数量、提升速度。如果需要，你仍然可以通过 pnpm add -g npm​ 来单独安装 npm。

📄 项目级配置：devEngines.runtime#

为了让团队使用统一的 Node.js 版本，可以将运行时要求写入项目的 package.json 文件中。这比在命令行手动切换更可靠。

在 package.json​ 中添加 devEngines.runtime 字段。例如，声明你的项目需要 Node.js v24.4.0 或更高版本：

json

1
{
2
  "devEngines": {
3
    "runtime": {
4
      "name": "node",
5
      "version": "^24.4.0",
6
      "onFail": "download"
7
    }
8
  }
9
}

这里的配置项含义如下：

• ​name​: "node"​，表示声明的是 Node.js 运行时。也支持 "deno"​ 或 "bun"。
• ​version​: "^24.4.0"​，一个 semver 版本范围。pnpm install​ 时会自动解析并安装符合该范围的最新版本，并将确切版本锁定在 pnpm-lock.yaml 中。
• ​onFail​: "download"​，定义了当本地环境不满足版本要求时的行为。可选值有 "download"​（自动下载）、"warn"​（仅警告）、"error"​（报错）或 "ignore"（忽略）。

配置后，只需运行 pnpm install，pnpm 就会根据配置自动处理 Node.js 的安装和校验。