通过NVM（Node Version Manager）管理 Node.js 版本

小新

一、NVM 安装（分系统）

1. Windows 系统：使用 nvm-windows

2. macOS/Linux 系统：使用原生 NVM

NVM（Node Version Manager）是管理多个 Node.js 版本的工具，允许你在不同项目间快速切换 Node.js 版本，尤其适合需要适配不同版本需求的开发场景。下面介绍 Windows 和 macOS/Linux 系统下的 NVM 使用方法及常用命令。

一、NVM 安装（分系统）

1. Windows 系统：使用 nvm-windows

Windows 不直接支持原生 NVM，需使用适配版本 nvm-windows：

下载地址：nvm-windows Releases
选择 nvm-setup.exe 安装（推荐），安装时注意：
- 若已安装 Node.js，会提示是否迁移现有版本，建议选择「是」；
- 确认安装路径（如 C:\nvm）和 Node.js _symlink 路径（如 C:\Program Files\nodejs）。

2. macOS/Linux 系统：使用原生 NVM

通过终端安装：

# 安装命令（从官方仓库）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 或使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 安装完成后，重启终端或执行以下命令使配置生效
source ~/.bashrc  # 或 ~/.zshrc（根据你的使用的 shell 调整）

二、NVM 常用核心命令

无论系统，核心命令基本一致（Windows 下使用 nvm，macOS/Linux 下也用 nvm）：

1. 版本管理基础

# 查看 nvm 版本（验证安装成功）
nvm version  # 或 nvm --version

# 查看可安装的 Node.js 版本（远程列表）
nvm list available  # Windows 专用
nvm ls-remote       # macOS/Linux 专用

# 安装指定版本的 Node.js
nvm install <版本号>
# 示例：安装 LTS 版（推荐）
nvm install --lts
# 示例：安装具体版本（如 18.18.0）
nvm install 18.18.0

2. 版本切换与使用

# 查看已安装的 Node.js 版本（带 * 表示当前使用版本）
nvm list   # Windows 专用
nvm ls     # macOS/Linux 专用

# 切换到指定版本（需先安装）
nvm use <版本号>
# 示例：切换到 18.18.0
nvm use 18.18.0
# 示例：切换到 LTS 版
nvm use --lts

# 设置默认版本（重启终端后仍生效）
nvm alias default <版本号>
# 示例：将 18.18.0 设为默认
nvm alias default 18.18.0

3. 版本卸载与清理

# 卸载指定版本
nvm uninstall <版本号>
# 示例：卸载 16.20.2
nvm uninstall 16.20.2

4. 其他实用命令

# 查看当前使用的 Node.js 版本（等价于 node -v）
nvm current

# 临时禁用 nvm（使用系统全局安装的 Node.js）
nvm deactivate  # macOS/Linux 专用

三、注意事项

权限问题：
- macOS/Linux 下避免使用 sudo 安装 Node.js 或运行 nvm 命令，否则可能导致权限错误。
- Windows 下建议以管理员身份打开终端，避免「无法创建 symlink」等错误。
版本兼容性：
- 安装 Node.js 时，nvm 会自动安装对应版本的 npm（无需单独安装）。
- 切换 Node.js 版本后，npm 版本也会自动切换（与该 Node 版本匹配）。
全局包路径：
- 不同 Node 版本的全局包（如 npm install -g xxx）会独立存储，切换版本后需重新安装全局包。
- 可通过 npm root -g 查看当前版本的全局包安装路径。

通过上述命令，你可以轻松管理多个 Node.js 版本，灵活应对不同项目的环境需求。如果需要切换版本，只需 nvm use <版本号> 即可，非常便捷。