Windows下nvm的安装与配置详细指南 – wiki大全


Windows下NVM的安装与配置详细指南

对于前端开发者和 Node.js 用户来说,在不同的项目中使用不同版本的 Node.js 是一个常见的需求。NVM (Node Version Manager) 就是一个出色的工具,它允许您在同一台计算机上轻松地安装、切换和管理多个 Node.js 版本。

本文将为您提供一个详尽的指南,帮助您在 Windows 系统上成功安装和配置 NVM。

第一步:卸载现有的 Node.js 版本

在安装 NVM 之前,强烈建议卸载您计算机上任何已有的 Node.js 版本。如果不卸载,可能会导致版本管理混乱或与 NVM 产生冲突。

您可以通过以下步骤卸载:

  1. 打开 Windows 的 “控制面板”。
  2. 选择 “程序” -> “卸载程序”。
  3. 在程序列表中找到 “Node.js”,右键点击并选择 “卸载”。
  4. 按照卸载向导完成即可。

同时,建议检查一下 C:\Program Files\ 目录下是否还存在 nodejs 文件夹,如果存在,请手动删除它。

第二步:下载 NVM for Windows

NVM 官方主要支持 macOS 和 Linux。对于 Windows 用户,我们需要使用一个由社区维护的、同样功能强大的版本 nvm-windows

  1. 访问下载页面:
    打开 nvm-windows 的 GitHub Releases 页面:
    https://github.com/coreybutler/nvm-windows/releases

  2. 选择安装包:
    在该页面的 “Assets” 部分,找到最新版本的 nvm-setup.exe 文件并下载。这是一个方便的安装程序,推荐大多数用户使用。

下载nvm-setup.exe

第三步:安装 NVM

下载完成后,双击 nvm-setup.exe 文件开始安装。

  1. 接受许可协议:
    阅读并接受许可协议。

  2. 选择 NVM 安装路径:
    安装程序会要求您选择 NVM 的安装目录。您可以使用默认路径(例如 C:\Users\YourUser\AppData\Roaming\nvm),也可以自定义。请确保路径中不包含任何中文或特殊字符

  3. 选择 Node.js Symlink 路径:
    接下来,安装程序会要求您为 Node.js 的 “symlink”(符号链接)选择一个路径。这是 NVM 用来切换不同 Node.js 版本的关键。同样,建议使用默认路径(例如 C:\Program Files\nodejs),并确保该文件夹目前不存在。

  4. 完成安装:
    点击 “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 了。

  1. 查看可安装的 Node.js 版本:
    您可以使用以下命令查看所有可供安装的 Node.js LTS (长期支持) 版本:

    bash
    nvm list available

  2. 安装指定的 Node.js 版本:
    选择一个您需要的版本进行安装。例如,安装 v18.17.0 版本:

    bash
    nvm install 18.17.0

    安装过程可能需要一些时间,因为它会从网络上下载 Node.js 的二进制文件。您也可以只输入主版本号来安装最新的稳定版,例如:

    bash
    nvm install 18

  3. 切换使用的 Node.js 版本:
    安装完成后,您可以使用 use 命令来切换当前活动的 Node.js 版本。例如,切换到刚刚安装的 18.17.0 版本:

    bash
    nvm use 18.17.0

    切换成功后,您可以通过以下命令来验证当前正在使用的版本:

    bash
    node -v
    npm -v

  4. 查看已安装的 Node.js 版本:
    如果您想查看本地已经安装了哪些版本,可以使用 list 命令:

    bash
    nvm list

    当前正在使用的版本前会有一个星号 * 标记。

  5. 设置默认 Node.js 版本:
    nvm use 命令只在当前终端窗口中生效。如果您希望每次打开新的终端时都使用某个特定版本,可以将其设置为默认版本。例如,将 18.17.0 设置为默认版本:

    bash
    nvm alias default 18.17.0

总结

通过遵循以上步骤,您应该可以在 Windows 系统上顺利地安装和配置 NVM。使用 NVM,您可以告别因项目需求不同而频繁卸载和重装 Node.js 的烦恼,极大地提高了开发效率。希望这篇详细的指南能对您有所帮助!

滚动至顶部