pnpm 10.14 支持JavaScript运行时的安装了

一、用corepack管理pnpm来支持运行时安装功能

在Node.js 25之前在里面集成了一个实验性的小工具:corepack,用来管理包管理器的,比如yarn、pnpm。想要支持JavaScript运行时的安装,可以先启用corepack:

corepack enable

然后指定项目所在pnpm的版本:

corepack prepare pnpm@9.15.4 --activate

接下来,安装Node.js版本:

pnpm env use --global 18

现在,pnpm 10.14 支持JavaScript运行时的安装了。

二、pnpm 10.14的支持方法

那我们在Monorepo项目中,要怎样配置呢?

具体配置步骤如下:

  1. 在项目根目录的package.json中添加devEngines.runtimes,指定运行时Node.js版本的范围:
Plain 复制代码
// package.json
{
  "devEngines": {
    "runtime": {
      "name": "node",
      "version": "^22.17.0",
      "onFail": "download" // we only support the "download" value for now
    }
  }
}
  1. 在子目录,也就是packages/app/package.json的配置是可以覆盖根目录配置的:
Plain 复制代码
// packages/app/package.json
{
  "devEngines": {
    "runtime": {
      "name": "node",
          "version": "^18.20.8",
          "onFail": "download"
    }
  }
}
  1. 结合node的版本管理工具volta实现版本切换:
Plain 复制代码
{
  "volta": {
        "node": "18.20.8",
        "pnpm: "9.15.4"
  }
}

当执行pnpm install时,如果你本地的开发环境的Node.js版本比如是16.x,而与项目所需要的版本是22.17。那么,就会通过你指定的版本范围去匹配:

锁文件(lockfile)会保存运行时的版本,以及校验和(checksum)。这样,在本地运行时,也可以保证环境的一致性。

三、用Volta自动切换版本

步骤的第3步,是由Volta通过volta pin命令在package.json中生成的volta字段。当进入项目的目录时,Volta自动切换到指定版本。不用像nvm那样手动操作了。

安装 Volta

在终端输入命令:

curl https://get.volta.sh | base

就会下载安装了:

指定Node的版本

输入volta pin node@22.17.0

就会在package.json中生成volta字段:

pnpm校验devEngines版本

当执行pnpm install时,pnpm会去校验devEngines.runtime的版本,查下版本是否符合。如果符合,就会安装依赖。如果volta指定的版本低于devEngines.runtime要求的版本范围,pnpm就会警告版本不匹配。

完整的package.json配置:

SQL 复制代码
{
  "devEngines": {
    "runtime": {
      "name": "node",
      "version": "^22.17.0",
      "onFail": "download"
    }
  },
  "volta": {
    "node": "22.17.0"
  }
}

四、总结

devEngines.runtime就是检查一下环境的兼容性,然后报个警给你而已。那么执行力这块,还需要volta这个"一次配置,全自动切换"的管理运行时版本的智能工具。