NVM（Node Version Manager）安装与使用教程

1- NVM（Node Version Manager）安装与使用教程

1.1- NVM 简介

NVM（Node Version Manager）是一个用于管理 Node.js 版本的工具。它允许用户在同一台设备上安装和切换多个 Node.js 版本，从而适应不同项目的需求。

无论是用于开发、测试还是生产环境，NVM 都能让版本管理变得简单而高效。

1.2- 安装指南

1.2.1- Windows 系统

  1. 下载安装包

    • 请从 GitHub 或国内镜像下载 nvm-windows 安装包（推荐使用国内镜像以提升下载速度）。

  2. 安装步骤

    • 双击运行下载的 nvm-setup.exe 安装包。
    • 按照提示选择 NVM 的安装路径（建议避免路径中包含空格或中文字符）以及 Node.js 默认安装路径。
    • 安装完成后，重启命令行终端，然后执行以下命令验证是否安装成功：

1.2.1.1- winget

winget install  CoreyButler.NVMforWindows

 nvm --version

1.2.2- macOS/Linux 系统

1.2.2.1- 通过 Curl 安装

  • 打开终端，执行以下命令：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

1.2.2.2- 通过 Homebrew 安装（仅适用于 macOS）

  • 确保已安装 Homebrew 后，运行命令：
brew install nvm
  1. 配置环境变量
  • 将以下内容添加到你的 shell 配置文件中（如 ~/.zshrc 或 ~/.bashrc）：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  • 保存文件后，重启终端或执行如下命令使配置生效：
source ~/.zshrc   # 或 source ~/.bashrc

1.3- 常用命令

1.3.1- NVM 常用的几个命令及其功能示例

命令 功能 示例
nvm install <version> 安装指定版本的 Node.js nvm install 16.18.0
nvm use <version> 切换当前使用的 Node.js 版本 nvm use 16.18.0
nvm ls 列出已安装的所有 Node.js 版本 nvm ls
nvm alias default <version> 设置默认的 Node.js 版本 nvm alias default 16
nvm uninstall <version> 卸载指定版本的 Node.js nvm uninstall 16

1.3.2- 代码块

  • 安装指定版本的 Node.js
nvm install <version>

示例：

nvm install 16.18.0
  • 切换当前使用的 Node.js 版本
nvm use <version>

示例：

nvm use 16.18.0
  • 列出已安装的所有 Node.js 版本
nvm ls
  • 设置默认的 Node.js 版本
nvm alias default <version>

示例：

nvm alias default 16
  • 卸载指定版本的 Node.js
nvm uninstall <version>

示例：

nvm uninstall 16

1.4- 配置镜像加速

为了提升 Node.js 和 npm 的下载速度，你可以配置国内镜像源。操作步骤如下：

1.4.1- Windows 上

  1. 打开命令行终端（如 CMD 或 PowerShell）。

1.4.1.1- 执行以下命令，检查 NVM 的路径

where nvm

输出结果通常会显示 NVM 的安装位置，例如：

C:\Program Files\nvm\nvm.exe

这意味着 NVM 安装在 C:\Program Files\nvm。

1.4.1.2- 如果以上方法无效，也可以尝试

  • 检查安装时选择的路径，默认可能是：
C:\Program Files\nvm
  • 在文件资源管理器中搜索 nvm.exe 文件。

1.4.2- macOS/Linux 上

  1. 打开终端并运行以下命令：
echo $NVM_DIR

输出结果会显示 NVM 的安装目录，通常是：

/Users/<你的用户名>/.nvm
  1. 如果没有看到任何结果，可以检查你的 ~/.zshrc 或 ~/.bashrc 配置文件，查看以下环境变量是否已配置：
export NVM_DIR="$HOME/.nvm"

  1. 打开 NVM 安装目录下的 settings.txt 文件。

  2. 添加或修改以下配置：

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

1.5- 环境变量配置（Windows）

确保 NVM 正常工作的关键在于正确配置环境变量，尤其在 Windows 系统上：

1.5.1- 用户变量

  • NVM_HOME: 设置为 NVM 的安装路径（例如：C:\Program Files\nvm）。
  • Path: 在用户变量中添加 %NVM_HOME% 和 %NVM_HOME%\node_global。

1.5.2- 系统变量

  • Path: 在系统变量中也需要添加 %NVM_HOME%\node_global。

1.6- 常见问题与解决方案

1.6.1- 安装失败

  • 问题原因：可能由于系统中已安装旧版本 Node.js 或安装路径包含空格/中文字符。
  • 解决方案：
    • 请先卸载系统中可能存在的旧版 Node.js。
    • 确保安装路径不包含空格或中文字符。
    • 检查下载的安装包是否完整，必要时尝试使用国内镜像重新下载。

1.6.2- 版本切换不生效

  • 问题原因：环境变量未及时生效或配置文件错误。
  • 解决方案：
    • 切换版本后，重启终端。
    • 对于 macOS/Linux 用户，可执行 source ~/.zshrc 或 source ~/.bashrc 使配置加载。
    • 如果项目根目录下存在 .nvmrc 文件，请确认其中配置的版本号是否正确。

1.7- 总结

NVM 提供了一套简单易用的命令来管理多版本的 Node.js，有助于解决开发中因环境不一引发的版本冲突问题。

  • Windows 用户：推荐使用 nvm-windows；
  • macOS/Linux 用户：可通过 Curl 或 Homebrew 安装 NVM。