Node.js 在每个环境中都已就绪:node、npm、npx 和 corepack 可在终端、智能体的命令以及 npm 脚本中使用。可以并存安装多个 Node.js 版本,每个项目使用它所要求的版本。
项目使用哪个版本
node、npm、npx 和 corepack 按以下顺序选择版本:
- 项目的
.nvmrc或.node-version文件(从您所在的文件夹向上查找到~/Code中项目的根目录),例如22、v22.11.0、lts/*或node; - 在面板上或通过
rdev node use为该项目选择的版本; - 默认版本。
文件要求的版本若未安装,会停止并提示您安装;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 之前全局安装的包会保留在当时的版本中;请重新安装一次。