nvm：Node 版本管理工具

nvm 是什么

nvm（Node Version Manager）是一款用于管理 Node.js 版本的工具。它允许在同一台机器上安装多个 Node 版本，并可随时切换。避免因不同项目依赖不同 Node 版本而导致冲突。

核心功能

  • 安装多个 Node 版本
  • 快速切换当前使用的版本
  • 卸载不再需要的版本
  • 隔离不同 Node 版本的全局包环境

简单原理
nvm 使用目录隔离不同 Node 版本，并在你切换版本时动态修改系统 PATH 指向对应版本。无需重新安装系统级 Node，也不会破坏现有项目。

Windows 平台的 nvm（nvm-windows）

Windows 不支持官方 Linux nvm 工具，需要使用专门为 Windows 编写的版本：
nvm-windows（又叫 nvm for Windows）
这是一个独立实现，与 Linux/macOS 的原版 nvm 不同，但功能一致。

Windows 安装步骤

卸载旧版 Node（若已安装）

以前直接从官网安装过 Node，需要先卸载：
控制面板 → 程序 → 卸载 Node.js
并删除可能遗留的目录：

1
2
C:\Program Files\nodejs
C:\Users\<你的用户名>\AppData\Roaming\npm

下载 nvm-windows

下载地址（官方 GitHub Releases）：

1
https://github.com/coreybutler/nvm-windows/releases

下载安装包：
nvm-setup.exe

安装步骤

安装过程只需注意两个路径：

  1. NVM 安装目录（可以自定义）
  2. Node.js Symlink 目录（可以自定义）

第二个目录是 nvm 切换版本时自动创建的链接目录，必须存在且不能被占用。

安装完成后，在终端输入：

1
nvm version

若输出版本号，说明安装成功。

nvm 的使用方法

查看可安装 Node 版本

1
nvm list available

安装指定版本 Node

1
nvm install 18.16.0

安装多个版本也可以，例如：

1
nvm install 20.19.0

查看本机已安装版本

1
2
3
4
nvm list

# 或使用
nvm ls

切换使用的版本

1
nvm use 18.16.0

切换后，执行：

1
node -v

即可看到当前生效版本。

卸载某个 Node 版本

1
nvm uninstall 18.16.0

设置 npm 全局包镜像（可选）

切换 Node 版本后，每个版本都有自己的 npm 环境。

配置 npm registry：

1
npm config set registry https://registry.npmmirror.com

nvm 的简单工作原理

  1. nvm 在 C:\Program Files\nodejs 建立一个“伪目录”（symlink：安装时你所指定的目录）。

  2. 当执行 nvm use 18.16.0 时：

    • 该目录指向真正的 Node 安装路径，如：

      1
      C:\Users\<user>\AppData\Roaming\nvm\v18.16.0\

    • 修改 PATH，让系统优先使用该路径里的 node.exe 和 npm.cmd。

  3. 切换版本仅改变 symlink 和 PATH，不需要重新安装系统级 Node。

这种方式避免了系统 Node 干扰，并能在多个版本间快速切换。

总结

nvm 是前端和 Node.js 后端开发的必备工具，尤其是在同时管理多个项目的情况下。nvm-windows 让在 Windows 上管理 Node 版本变得简单稳定。

主要能力

  • 安装多个版本
  • 一条命令切换版本
  • 不污染系统 PATH
  • 每个版本拥有自己的 npm 环境

适合所有需要使用 Node 的开发者。