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 安装包（推荐使用国内镜像以提升下载速度）。
   • 双击运行下载的 nvm-setup.exe 安装包。
   • 按照提示选择 NVM 的安装路径（建议避免路径中包含空格或中文字符）以及 Node.js 默认安装路径。

2. 或使用 winget 安装

winget install CoreyButler.NVMforWindows

3. 验证安装

安装完成后，重启命令行终端，执行以下命令验证是否安装成功：

nvm --version

1.2.2. macOS/Linux 系统

1.2.2.1. 通过 Curl 安装

• 打开终端，执行以下命令：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

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

• 确保已安装 Homebrew 后，运行命令：

brew install nvm

1.2.2.3. 配置环境变量

• 将以下内容添加到你的 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. 常用命令一览

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），执行以下命令，检查 NVM 的路径：

where nvm

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

C:\Program Files\nvm\nvm.exe

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

2. 如果以上方法无效，也可以尝试：

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

3. 打开 NVM 安装目录下的 settings.txt 文件，添加或修改以下配置：

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

1.4.2. macOS/Linux 上

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

echo $NVM_DIR

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

/Users/<你的用户名>/.nvm

2. 如果没有看到任何结果，可以检查你的 ~/.zshrc 或 ~/.bashrc 配置文件，查看以下环境变量是否已配置：

export NVM_DIR="$HOME/.nvm"

3. 设置镜像源：在 shell 配置文件中添加以下环境变量后重新加载终端：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm/

注：settings.txt 是 nvm-windows 的配置文件，仅适用于 Windows；macOS/Linux 的 nvm 通过上面的环境变量设置镜像。

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。