大家在开发过程中是如何管理多个项目不同的 NodeJS 版本的?

发布于 1周前 作者 zlyuanteng 来自 nodejs/Nestjs

本地会开发多个不同的 NodeJS 项目,每个项目可能需要的 Node 版本不同,有的老项目还在用 10.xx ,有的要求 12.xx/14.xx/16.xx/18.xx 。

总之,每个项目都需要不同的 Node 版本。很多时候我都是在启动项目遇到报错了才会意识到要切换 Node 版本。


大家在开发过程中是如何管理多个项目不同的 NodeJS 版本的?
95 回复

nvm 了解下,百度不会吗 兄弟


nvm 肯定是要用的, 还可以配合 conda 定制各种不同的环境, 不同项目必须要隔离开来, 否则真的是头大

抱歉,我描述的不是很清楚。

nvm, n 这些版本管理工具我是在用的。

我的问题是:
1. 这些工具都需要你去手动切换 Node 版本,而不能做到启动一个不同的项目可以自动选择指定版本的 Node 来运行(或者是我不知道?)。

2. 当你使用一个不兼容的 Node 版本运行项目的时候,只要等到代码报错,才会意识到 Node 版本有问题。
我知道 package.json 里有个engines字段可以指定 Node 版本,但很多项目是没有指定的 https://docs.npmjs.com/cli/v10/configuring-npm/package-json#engines


之前公司是把 Node 和 NPM 的执行文件直接打包到项目中提交到 git 的,这样可以保证每个人都适用正确的版本来运行项目。

把版本切换命令写到 package.json script 里面

#12

> 而不能做到启动一个不同的项目可以自动选择指定版本的

https://volta.sh/



感谢!

看起来 Volta 确实就是我想要的工具,我研究一下

Fast: Install and run any JS tool quickly and seamlessly! Volta is built in Rust and ships as a snappy static binary.

Reliable: Ensure everyone in your project has the same tools—without interfering with their workflow.

Universal: No matter the package manager, Node runtime, or OS, one command is all you need: volta install.

根目录添加 .nvmrc 内容为 lts/hydrogen
nvm 可以自动切换版本



在每个项目根目录下加一个.nvmrc 文件,指定 node 版本,打开终端自动切换

我觉得可以用 conda 管理环境

windows:nvm ( volta 不支持 32bit )
mac:volta

我用 fnm 跨平台 项目中创建一个.node-version 文件 里面写个 14/16/18 的版本号就能自动切换 node 版本了

项目根目录放.nvmrc
cd 进去自动切

为什么不试试 docker 呢

mac 用 n 指令 window 用 nvm

fnm ,支持 win 下自动切换

试了一下#18 的方法, 不知道为什么执行 nvm use 的时候显示 Invalid version 。看到 https://blog.csdn.net/weixin_49230250/article/details/131771608#nvm%20use%20%E6%97%A0%E6%95%88%E6%9C%80%E7%BB%88%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88 这个可行。


谢谢,有时间研究一下。

想要一个侵入性比较小的方案,记的之前写 Python 的时候用 venv 还挺方便的。不知道 Node 有没有类似的

用后端的眼光来看前端的工程化做得真是一言难尽,这种库/框架的多版本共存在后端看来根本就不是问题,前端的生态整得真复杂。

有一个 npm install n -g

windows nvm
macos n

#15 volta 现在处于没人维护的状态,有段时间没更新了。volta 的想法很好,内部要做很多的 dirty work ,我自己实际用起来和新工具链的配合还有问题,例如 pnpm 目前也没很好的支持,pnpm 本身也无意为 volta 适配。最近我从 volta 迁移出来了,用 fnm 来管理 node ,简单直观

直接放在 wsl 的容器里开发.得了



感谢提醒,看了下确实 Volta 的最近提交已经是 4 月份了。另外,刚才安装简单试了一下,它还是会在 package.json 里添加字段的,对工作中团队使用的话会有点侵入性。

fnm 看起来也不错,有时间试试

我也觉得,前端各种黑魔法,各种工具,复杂的不行。

nvm. n 等等都可以

volta ,不过和 pnpm 配合貌似有些问题

pnpm 也是可以管理 node 的 https://pnpm.io/cli/env

source .env.sh 可以直接写在 npm 命令里

除了楼上提到的那些之外,我说一下我自己的场景。目前 node18, 20 并存,具体用哪个版本写在了 CI 配置文件里面(因为一些原因有些升级不上去 20 ),找 GPT 写了个脚本 读取 CI 配置文件并且运行 nvm use xxx 。然后设置 alias ,叫做 autoenv 。
进到项目之后
$ autoenv
$ npm xxxx
就可以,习惯之后还挺省事的

rtx (asdf 的 rust clone )
one tool to rule them all

project based 版本可以 rtx local node16 在项目根目录生成.tool_version 文件,以后会自动加载

webstorm 可以,自己的全局管理用的 scoop

fnm 不愿意支持 engine ,所以写了这个项目

https://github.com/Schniz/fnm/issues/39

fnm+.node-version 文件就可以实现

我的做法是全局的版本一直保持最新,用“export PATH=/D/Node/node-v14.21.1-win-x64:$PATH”给当前会话添加环境变量,就可以指定 node 版本了,缺点就是有时候会忘记加,还要记住不同项目使用的 node 版本,其实用 webstorm 就可以指定项目的 node 版本

rtx 啊不但 node python golang 等其它的语言版本也能管理

用 asdf 的 nodejs 插件,好像可以自动切换 node 版本,它会自动读 .nvmrc 或 .node-version 文件匹配

直接用 webstorm 就行

如果用 vscode 开发的,可以尝试下 devcontainer 。

当然是 volta 了 rust 写的
一个项目对应一个 node 版本
nvm 我用的时候老是出问题 安装的时候 还要删除版本什么的 早都放弃了

fnm env --use-on-cd | source # 根据目录下的配置自动切换 node 版本
fnm current > .nvmrc

git checkout 后直接做一步 nvm 切换版本吧,husky 有 post-checkout 的钩子可以用

如果是需要同时开发跑着好几个不同版本 node 的项目,这种情况的话有没什么办法支持
例如我同时要跑只支持 node14 16 18 版本的项目

我都是用环境变量隔离的,使用前用脚本拉一下对应的环境变量,没觉得有啥不方便。

fnm

.node-version 或 .nvmrc 文件确定项目版本

本地 nvm 开发,然后打成 image

有 nvm 又不愿意手动切换,你这个要求是有点高了,要求高,那你就要付出劳动,搞多个版本在 docker 里跑,在本地用 shell 脚本调用不同版本的 npm 路径来执行,gradle 也可以搞,cicd 的 jenkins 发布也是这个道理,前提是你要付出更复杂的劳动,但是如果你只是为了在单机开发调试用,整个团队都这么干,要累死人,所以还有一种方式就是云开发,大家都在云上的 ide 上开发,每个项目选择不同的 ide 去玩,但这些方案都需要付出更多的劳动

就没人用软链接吗?

Windows 、Linxu 、macOS 都可以,下载 nodejs 按目录(版本号)存放,

在 环境变量 或 .bash_profile 中 添加 /dev/nodejs/node.js

再写个脚本命令来切换;
------------------------------------------------------------------

/dev/nodejs/node.js -> /dev/nodejs/v8.9.4-win-x64

/dev/nodejs/v18.12.1-win-x64

建议你换个提问方式:先把你百度/谷歌/必应到的,或者其他社区其他渠道获取到的解决方案放到主贴内,抛砖引玉式的寻求更优解,大家也可以根据你的当前认知来提供更细致和全面的回答

fnm
.node-version 写项目需要的版本

咬咬牙升一波,统一一下。之前用 nvm ,jenkins 上的 nvm 插件总出问题,影响构建效率和心情,后来分析了一波统一升了一次,就不用纠结这事了

asdf ,每个项目加配置定版本不用手动切换

nvm
或者 webstorm 运行配置指定 node 版本

你如果非要听点不一样的答案,那就 docker 吧

如果不肯把全部项目升级到统一版本,我一般就是去 https://nodejs.org/en/download 把各个版本的 zip 包下载解压到不同路径,敲命令时使用绝对路径的 node/npm

bash<br>asdf local nodejs latest:18<br>git add .tool-versions<br>

我是 windows 系统,基于 nvm+我自己写的 vscode 插件-vscode-nvmrc ,切换 vscode 实例时插件去读取 nvmrc 文件执行 nvm use ,

直接 source

直接 source
export PATH=$NODE_HOME/bin:$PATH

我使用 Quicker 给 cmder 弄了快捷面板,里面有好几个按钮可以快速 cd 到不同项目。
以上是前提。

然后我使用的是 nvs ,它可以为每一个 cmder tab 终端实例指定一个 node 版本来运行。


然后就是刚才说的快捷面板,我就相当于在 cd 之后,再一次执行 nvs use ,一个快捷动作处理两个事情:cd path/project + nvs use

webstorm 每个项目都可以设置自己的 nodejs 路径,比较方便。

用 nvm 启动项目就可以不用手动切换默认 node 版本

nvm run 16 app.js
nvm run 18.0 app.js

你的精力够同时应付几个项目?手动切一下很快呀

用 dev container

加一个启动前的脚本切换一下呢

公司项目 node 版本 已经 统一用 volta 管理了 不需要手动切换

volta 可以,我也是这个需求,所以想换别的没法换

在开发过程中管理多个项目不同的Node.js版本,推荐使用以下工具和方法:

一、NVM(Node Version Manager)

NVM是Node.js版本管理的流行工具,允许在同一台机器上安装和切换不同版本的Node.js。

  1. 安装NVM

    • Linux/macOS:通过curl或wget命令从NVM的GitHub仓库安装。
    • Windows:使用nvm-windows,下载地址:NVM Windows安装包
  2. 使用NVM

    • 安装Node.js版本:nvm install <version>
    • 列出所有已安装的版本:nvm list
    • 切换到某个版本:nvm use <version>
    • 设置默认版本:nvm alias default <version>

二、N

N是另一个流行的Node.js版本管理工具,允许快速安装和切换Node.js版本。

  1. 安装Nnpm install -g n

  2. 使用N

    • 安装Node.js版本:n <version>
    • 切换到最新稳定版:n stable

三、Docker

Docker通过为每个Node.js项目创建一个包含特定Node.js版本的Docker容器,确保项目的环境一致性。

四、环境变量

在某些情况下,通过设置环境变量来指定Node.js的版本,这通常在使用特定的包管理工具或IDE时很有用。

综上所述,NVM因其强大的功能和灵活性,通常是管理多个Node.js版本的首选工具。

回到顶部