Windows下NVM的安装与配置详细指南
对于前端开发者和 Node.js 用户来说,在不同的项目中使用不同版本的 Node.js 是一个常见的需求。NVM (Node Version Manager) 就是一个出色的工具,它允许您在同一台计算机上轻松地安装、切换和管理多个 Node.js 版本。
本文将为您提供一个详尽的指南,帮助您在 Windows 系统上成功安装和配置 NVM。
第一步:卸载现有的 Node.js 版本
在安装 NVM 之前,强烈建议卸载您计算机上任何已有的 Node.js 版本。如果不卸载,可能会导致版本管理混乱或与 NVM 产生冲突。
您可以通过以下步骤卸载:
- 打开 Windows 的 “控制面板”。
- 选择 “程序” -> “卸载程序”。
- 在程序列表中找到 “Node.js”,右键点击并选择 “卸载”。
- 按照卸载向导完成即可。
同时,建议检查一下 C:\Program Files\ 目录下是否还存在 nodejs 文件夹,如果存在,请手动删除它。
第二步:下载 NVM for Windows
NVM 官方主要支持 macOS 和 Linux。对于 Windows 用户,我们需要使用一个由社区维护的、同样功能强大的版本 nvm-windows。
-
访问下载页面:
打开nvm-windows的 GitHub Releases 页面:
https://github.com/coreybutler/nvm-windows/releases -
选择安装包:
在该页面的 “Assets” 部分,找到最新版本的nvm-setup.exe文件并下载。这是一个方便的安装程序,推荐大多数用户使用。

第三步:安装 NVM
下载完成后,双击 nvm-setup.exe 文件开始安装。
-
接受许可协议:
阅读并接受许可协议。 -
选择 NVM 安装路径:
安装程序会要求您选择 NVM 的安装目录。您可以使用默认路径(例如C:\Users\YourUser\AppData\Roaming\nvm),也可以自定义。请确保路径中不包含任何中文或特殊字符。 -
选择 Node.js Symlink 路径:
接下来,安装程序会要求您为 Node.js 的 “symlink”(符号链接)选择一个路径。这是 NVM 用来切换不同 Node.js 版本的关键。同样,建议使用默认路径(例如C:\Program Files\nodejs),并确保该文件夹目前不存在。 -
完成安装:
点击 “Install” 并等待安装过程结束。
第四步:验证安装
为了验证 NVM 是否已成功安装,您需要重新打开一个新的命令提示符(CMD)或 PowerShell 窗口。
在新的终端窗口中,输入以下命令:
bash
nvm -v
如果安装成功,您会看到 NVM 的版本号,例如 1.1.9。
您也可以直接输入 nvm,如果能看到 NVM 的所有命令列表,则证明安装完全成功。
Running version 1.1.9.
... (后面会跟一长串命令使用说明)
注意: 如果您在安装前已经打开了终端窗口,必须关闭并重新打开一个新的窗口,否则系统无法识别 nvm 命令。
第五步:使用 NVM 管理 Node.js 版本
现在 NVM 已经安装完毕,您可以开始用它来管理 Node.js 了。
-
查看可安装的 Node.js 版本:
您可以使用以下命令查看所有可供安装的 Node.js LTS (长期支持) 版本:bash
nvm list available -
安装指定的 Node.js 版本:
选择一个您需要的版本进行安装。例如,安装v18.17.0版本:bash
nvm install 18.17.0安装过程可能需要一些时间,因为它会从网络上下载 Node.js 的二进制文件。您也可以只输入主版本号来安装最新的稳定版,例如:
bash
nvm install 18 -
切换使用的 Node.js 版本:
安装完成后,您可以使用use命令来切换当前活动的 Node.js 版本。例如,切换到刚刚安装的18.17.0版本:bash
nvm use 18.17.0切换成功后,您可以通过以下命令来验证当前正在使用的版本:
bash
node -v
npm -v -
查看已安装的 Node.js 版本:
如果您想查看本地已经安装了哪些版本,可以使用list命令:bash
nvm list当前正在使用的版本前会有一个星号
*标记。 -
设置默认 Node.js 版本:
nvm use命令只在当前终端窗口中生效。如果您希望每次打开新的终端时都使用某个特定版本,可以将其设置为默认版本。例如,将18.17.0设置为默认版本:bash
nvm alias default 18.17.0
总结
通过遵循以上步骤,您应该可以在 Windows 系统上顺利地安装和配置 NVM。使用 NVM,您可以告别因项目需求不同而频繁卸载和重装 Node.js 的烦恼,极大地提高了开发效率。希望这篇详细的指南能对您有所帮助!