当前位置：首页 > ops >正文

使用nvm管理多个node版本（附安装教程）

ops 2025/8/13 13:18:22

前言

在前端开发中，我们经常需要同时维护多个项目，而这些项目可能依赖不同版本的Node.js。直接安装和卸载不同版本不仅麻烦，还容易导致环境混乱。
nvm（Node Version Manager）正是解决这一痛点的利器，它允许我们在同一台机器上轻松安装、切换和管理多个Node.js版本。

一、nvm简介

nvm是一个Node.js版本管理工具，支持在多个Node.js版本之间快速切换。它的主要优势包括：

多版本共存：无需卸载即可安装多个Node版本
快速切换：一条命令即可切换项目所需的Node版本
隔离环境：不同项目使用不同Node版本互不干扰

二、卸载Node

为确保NVM能够完全掌控Node版本管理，安装前需卸载系统中已存在的Node.js。这一步骤可避免与NVM管理的Node版本冲突及环境变量混乱。若此前未安装过Node.js，则可直接跳过此步骤

1、打开控制面板，找到并卸载 node.js

在这里插入图片描述

2、删除node的安装目录，一般来说node卸载后就会自动删除

默认的安装路径是C:\Program Files\nodejs和C:\Program Files (x86)\nodejs，取决于安装时的选择，如果还存在则需要手动删除。

3、删除C盘中遗留的文件

C:\Users\用户名\AppData\Roaming\npm
C:\Users\用户名\AppData\Roaming\npm-cache
C:\Users\用户名\AppData\Local\npm-cache
在这里插入图片描述

4、删除node环境变量

在这里插入图片描述

5、确认是否成功删除

在cmd窗口输入node -v进行验证，出现下面这个提示，node就是删干净了
在这里插入图片描述

三、安装nvm

1、下载nvm安装包

官方地址：https://www.nvmnode.com
在这里插入图片描述

2、运行安装程序，按照向导完成安装

验证安装是否成功：
在cmd窗口输入一下命令，能正常输出版本信息，则代表安装成功
在这里插入图片描述

3、配置nvm环境变量

在用户变量和系统变量中都加上下面两个系统变量
其中 NVM_HOME 是nvm安装目录，NVM_SYMLINK 是node存放目录
在这里插入图片描述

另外两个path环境还需要加上下面这两个配置
在这里插入图片描述

4、更换nvm安装源地址

因为node安装地址是国外地址，下载较慢，所以我们需要换成国内镜像地址。
找到nvm安装目录下的settings.txt文件，打开后在文件内容最后面增加下面两行代码

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

在这里插入图片描述

四、nvm的使用

1、安装node

nvm install <version>

确定需要安装的版本号，使用命令nvm list available 查看可用版本（这个命令输出可用版本不全）
在这里插入图片描述
也可以去https://nodejs.org/en/download/releases查看所有可用版本。

在确定需要安装的node版本后，例如需要安装的版本是22.18.0，使用命令 nvm install 22.18.0进行安装
在这里插入图片描述
命令执行完之后出现上述信息，或者在nvm安装目录能看到对应node版本，就表示安装成功了

2、使用node

nvm use <version>

使用命令nvm ls查看已安装的node版本，然后使用命令nvm use 22.18.0 就能切换当前node使用版本
在这里插入图片描述
*号所在位置就表示当前使用的node版本。如上图显示，最后一次执行的 nvm ls 输出的结果，*就在我切换的 22.18.0 上，表示切换成功。

3、卸载node版本

nvm uninstall <version>

当不再需要某个node版本时，例如 22.18.0 ，执行命令nvm uninstall 22.18.0 就能卸载
在这里插入图片描述

4、确认node环境

切换成功后确认node环境，执行命令node -v 和npm -v
在这里插入图片描述
能输出对应版本号，就代表环境正常

5、配置npm淘宝镜像

为了让npm下载速度快一些，使用国内镜像地址—淘宝镜像

npm config set registry https://registry.npmmirror.com

6、常用命令汇总

命令	说明
nvm on	启用 nvm（解决 nvm: command not found 问题）
nvm off	禁用 nvm
nvm --version	查看 nvm 自身版本
nvm list available	查看可下载的 nodejs 版本
nvm install <version>	安装指定版本
nvm use <version>	使用指定版本（仅当前终端生效）
nvm alias default <version>	设置默认版本（所有新终端生效）
nvm ls	列出已安装版本
nvm uninstall <version>	卸载指定版本
nvm install --lts	安装最新的 LTS（长期支持）版本
nvm use --lts	切换到最新的 LTS 版本
nvm ls-remote	列出远程可用版本
nvm current	显示当前使用的 Node.js 版本
nvm cache clear	清空 nvm 缓存（解决安装失败问题）