# NVM (Node Version Manager) 使用文档

## 一、什么是 NVM？

NVM（Node Version Manager）是一个用于管理多个 Node.js 版本的工具。它可以让你在同一台机器上安装、切换和使用不同版本的 Node.js，非常适合需要兼顾不同项目 Node.js 版本需求的开发者。

---

## 二、安装 NVM

### 2.1 一键安装

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

### 2.2 加载 NVM

安装完成后，需要重新加载终端或者执行以下命令使 nvm 生效：

```bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
```

### 2.3 验证安装

```bash
nvm --version
```

---

## 三、配置镜像源（加速 Node.js 下载）

在国内使用 nvm 下载 Node.js 时，建议配置淘宝镜像源以提高下载速度。

### 临时配置（仅当前会话生效）

```bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
```

### 永久配置（写入 shell 配置文件）

```bash
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
source ~/.bashrc
```

---

## 四、NVM 常用命令

### 4.1 安装 Node.js

```bash
# 安装最新稳定版
nvm install node

# 安装指定版本
nvm install 20.11.0

# 安装最新的 LTS 版本
nvm install --lts
```

### 4.2 查看可安装的版本

```bash
# 列出所有可安装的版本
nvm ls-remote

# 列出所有 LTS 版本
nvm ls-remote --lts
```

### 4.3 切换 Node.js 版本

```bash
# 使用指定版本
nvm use 20.11.0

# 使用最新稳定版
nvm use node

# 使用最新的 LTS 版本
nvm use --lts
```

### 4.4 查看已安装的版本

```bash
nvm ls
```

### 4.5 设置默认版本

```bash
# 设置系统默认使用的 Node.js 版本
nvm alias default 20.11.0

# 将最新稳定版设为默认
nvm alias default node
```

### 4.6 卸载 Node.js 版本

```bash
nvm uninstall 20.11.0
```

---

## 五、版本管理实践

### 5.1 为项目指定 Node.js 版本

在项目根目录创建 `.nvmrc` 文件：

```bash
# .nvmrc 文件内容示例
20.11.0
```

然后在该目录下运行 `nvm use` 即可自动切换到对应版本。

### 5.2 查看当前使用的版本

```bash
node -v
npm -v
```

### 5.3 版本别名管理

```bash
# 创建别名
nvm alias myapp 20.11.0

# 使用别名切换
nvm use myapp

# 删除别名
nvm unalias myapp
```

---

## 六、常见问题

### 6.1 命令找不到（command not found）

如果重启终端后出现 `nvm: command not found`，请确保已将 nvm 加载命令添加到 `~/.bashrc`、`~/.zshrc` 或 `~/.profile` 文件中。

### 6.2 下载速度慢

配置淘宝镜像源即可解决：

```bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
```

### 6.3 权限问题

使用 nvm 安装的 Node.js 不需要 `sudo` 权限，如果遇到权限问题，请检查是否使用了系统自带的 Node.js。

---

## 七、常用命令速查表

| 命令 | 说明 |
|------|------|
| `nvm --version` | 查看 nvm 版本 |
| `nvm install <version>` | 安装指定版本 |
| `nvm install node` | 安装最新稳定版 |
| `nvm install --lts` | 安装最新 LTS 版本 |
| `nvm use <version>` | 切换使用指定版本 |
| `nvm ls` | 列出已安装版本 |
| `nvm ls-remote` | 列出远程所有版本 |
| `nvm alias default <version>` | 设置默认版本 |
| `nvm uninstall <version>` | 卸载指定版本 |
| `nvm current` | 显示当前使用的版本 |

---

> 文档版本: v1.0
> 最后更新: 2025年