至少输入两个字母,即可搜索文档的所有页面。

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

Node.js 版本

Node.js 在每个环境中都已就绪:node、npm、npx 和 corepack 可在终端、智能体的命令以及 npm 脚本中使用。可以并存安装多个 Node.js 版本,每个项目使用它所要求的版本。

项目使用哪个版本

node、npm、npx 和 corepack 按以下顺序选择版本:

  1. 项目的 .nvmrc 或 .node-version 文件(从您所在的文件夹向上查找到 ~/Code 中项目的根目录),例如 22、v22.11.0、lts/* 或 node;
  2. 在面板上或通过 rdev node use 为该项目选择的版本;
  3. 默认版本。

文件要求的版本若未安装,会停止并提示您安装;rdev 不会自行安装。不支持 ^20 这样的版本范围;请改写主版本号。

在面板上

在侧边栏的服务器中打开服务器,然后进入运行时。Node.js 卡片列出已安装的版本及其确切的发行版,以及哪些项目固定使用了每个版本。添加 Node.js 版本会安装另一个版本(当前发行版和仍在维护的 LTS 系列:目前为 26、24 和 22);该版本的最新发行版会从 nodejs.org 下载,并根据其公布的校验和进行检查。版本上的 ⋯ 菜单可将其设为默认或移除;默认版本以及被项目固定使用的版本无法移除。在项目下,项目旁边的铅笔图标可将其固定到某个版本,或恢复为默认。这需要 rdev 0.2.0-beta.35 或更高版本。

在服务器上

rdev node list            # installed and available versions, the default and the pinned projects
rdev node install 22      # the newest Node 22
rdev node default 22
rdev node use shop 22     # pin a project; rdev node use shop default undoes it
rdev node remove 24
rdev node update          # the newest release of every installed version

智能体使用相同的命令,并通过 MCP 使用 rdev_node_list、rdev_node_install 和 rdev_node_project。当订阅需要处理时,安装、移除和切换版本会像 PHP 一样被暂停。

全局包

npm install -g 无需 sudo 即可使用,全局包由所有 Node.js 版本共享,因此您只需安装一次 CLI,无论项目使用哪个版本,它都保留在 PATH 中。带有原生插件的包是针对安装它的版本构建的;如果切换后出现问题,请重新安装。在 rdev 0.2.0-beta.35 之前全局安装的包会保留在当时的版本中;请重新安装一次。