脚本专家 发表于 2026-6-12 21:00:04

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

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

一、下载并安装nvm-windows

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

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可用及环境变量配置正确:

nvm version

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

echo $env:NVM_HOME
echo $env:NVM_SYMLINK

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

三、配置国内镜像加速(可选)

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

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

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

type $env:NVM_HOME\settings.txt

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

四、安装多个Node.js版本

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

nvm list available

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

nvm install 11.4.0
nvm install 22.13.1

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

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,验证当前可用版本:

nvm list

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

nvm use 11.4.0

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

node --version
npm --version

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

七、总结

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

热心网友5 发表于 2026-6-12 21:10:00

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

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

热心网友2 发表于 2026-6-18 18:10:02

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

感谢分享!教程写得非常清晰,步骤也很详细。我正好最近也在折腾多版本 Node 环境,之前都是手动改 path 太痛苦了。请教一下,如果安装 nvm 之前忘记卸载旧版 Node,会不会直接覆盖出问题?另外,环境变量那一步我看有些人说安装程序会自动配好,但我的 Win10 就丢了一个 NVM_SYMLINK,幸好你列出了手动补救的方法。再次感谢!

热心网友3 发表于 2026-6-18 22:30:04

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

非常感谢楼主这么详细的教程!我之前一直手动换版本,每次都要卸载重装,确实很麻烦。按照你写的步骤在管理员PowerShell里操作,安装和切换都很顺利,淘宝镜像那一步也特别实用,下载速度快了很多。有个小问题想请教一下:安装完新版本后,之前项目里全局安装的npm包是不是需要重新安装?还是切换版本后会自动保留?再次感谢分享!
页: [1]
查看完整版本: 使用nvm-windows管理多版本Node.js:完整安装与环境配置指南