使用nvm-windows管理多版本Node.js：完整安装与环境配置指南

脚本专家

在日常开发中，同时维护多个Node.js项目经常需要切换不同版本的Node.js运行环境。手动卸载重装不仅效率低，还容易残留旧版本文件，导致环境混乱。本文将介绍利用nvm-windows工具统一管理Node.js多版本，并完成环境变量配置与版本切换的完整流程。所有操作均在Windows系统下以管理员身份运行PowerShell。

一、下载并安装nvm-windows

首先确保当前系统中已卸载所有已安装的Node.js版本，否则后续符号链接可能冲突。打开管理员PowerShell，执行以下命令下载nvm-setup.exe：

2. Invoke-WebRequest -Uri "https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe" -OutFile "$env:USERPROFILE\Downloads\nvm-setup.exe"

复制代码

下载完成后双击运行安装程序。依次同意许可协议，根据个人偏好设置nvm安装路径（例如D:\Software\nvm）以及Node.js符号链接路径（例如D:\Software\nodejs）。安装程序会自动配置大部分环境变量，但后续仍需验证。

二、验证安装与环境变量

安装完毕后，重新以管理员身份打开PowerShell，依次运行以下三条命令确认nvm可用及环境变量配置正确：

2. nvm version

复制代码

该命令应返回类似“1.1.12”的版本号。接着检查环境变量：

2. echo $env:NVM_HOME
3. echo $env:NVM_SYMLINK

复制代码

输出的路径应与安装时选择的nvm安装路径和符号链接路径一致。如果为空，则需要手动添加系统变量（见第六节）。

三、配置国内镜像加速（可选）

国内用户访问官方Node.js镜像可能较慢，可配置淘宝镜像。在管理员PowerShell中执行：

2. nvm node_mirror https://npmmirror.com/mirrors/node/
3. nvm npm_mirror https://npmmirror.com/mirrors/npm/

复制代码

设置后可通过以下命令查看配置文件确认：

2. type $env:NVM_HOME\settings.txt

复制代码

文件中应包含两行mirror地址。

四、安装多个Node.js版本

先查看线上可用的LTS版本列表：

2. nvm list available

复制代码

根据输出选择合适的版本号进行安装。例如同时安装Node.js 11.4.0和22.13.1：

2. nvm install 11.4.0
3. nvm install 22.13.1

复制代码

安装完成后可用以下命令查看实际存储位置：

2. Get-ChildItem D:\Software\nvm

复制代码

（请将路径替换为你的nvm安装目录）在nvm安装目录下会看到以版本号命名的文件夹，每个文件夹内包含对应版本的node.exe及相关文件。

五、手动配置系统环境变量（如果安装程序未自动添加）

右击“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中新建两个变量：
- 变量名：NVM_HOME，变量值：你的nvm安装路径（例如D:\Software\nvm）
- 变量名：NVM_SYMLINK，变量值：你的符号链接路径（例如D:\Software\nodejs）

然后在系统变量中找到Path变量并编辑，添加以下两行：
- %NVM_HOME%
- %NVM_SYMLINK%

确保Path中不包含其他指向旧Node.js的路径，最后点击所有“确定”保存。

六、切换并使用指定Node.js版本

完成配置后，关闭并重新以管理员身份打开PowerShell，验证当前可用版本：

2. nvm list

复制代码

输出列表会显示本地已安装的版本，并在当前使用版本前标注星号。切换版本使用：

2. nvm use 11.4.0

复制代码

版本号须为已安装的版本。切换成功后，验证Node.js和npm版本：

2. node --version
3. npm --version

复制代码

应显示刚切换的版本号，说明环境已生效。

七、总结

通过nvm-windows工具，开发者可以在Windows系统中轻松安装、切换并管理多个Node.js版本，避免因项目依赖不同而反复卸载重装。关键步骤包括：卸载旧版Node.js、设置nvm安装路径与符号链接、配置镜像源、通过nvm install/nvm use命令管理版本、并确保环境变量正确指向NVM_HOME和NVM_SYMLINK。建议将nvm安装路径放在不包含中文和空格的目录中，以减少潜在问题。此方法同样适用于npm包管理器，切换版本时npm会自动跟随Node.js版本。

热心网友5

感谢楼主分享这么详细的nvm-windows配置教程！步骤非常清晰，尤其是提醒先卸载旧版Node.js、用管理员权限运行PowerShell，还有环境变量设置和镜像加速这些细节，对于新手来说特别友好。我之前手动画Path经常漏掉，看到你列出NVM_HOME和NVM_SYMLINK的检查方法就放心多了。另外，安装路径避开中文和空格这个建议很实用，之前踩过类似的坑。按照你的流程已经成功装上了11.4.0和22.13.1，切换也很流畅，感谢！