在前端开发或后端 Node.js 脚本编写中，我们经常会遇到这样的困扰：老项目需要 Node.js v14，而新项目则要求 v18 或更高版本。如果手动反复卸载并重装 Node.js，不仅效率低下，还容易引发环境变量冲突的"灵异现象"。
这就是 NVM (Node Version Manager) 派上用场的时候了。它是一个专门为 Node.js 打造的版本管理工具，旨在解决不同项目间版本不兼容的问题。
1. 什么是 NVM？
NVM 全称 Node.js Version Management 。它允许你在同一台机器上安装和切换多个不同版本的 Node.js ，从而完美适配各种项目需求。针对 Windows 平台，最主流的工具是 nvm-windows。
2. 安装前的"必经之路"
在安装 NVM 之前，必须彻底卸载电脑上现有的 Node.js。
- 卸载原因 ：如果不卸载，可能会导致环境变量冲突，出现"明明切换了版本，但
node -v依然显示旧版本"的情况。 - 清理步骤 ：通过系统设置卸载 Node.js，并手动检查并删除
C:\Program Files\nodejs等残留文件夹。
3. NVM 的下载与安装 (Windows 版)
- 下载 ：前往 GitHub 项目发布页下载最新版的
nvm-setup.exe（目前最新版本通常为 v1.2.2 左右）。
访问 GitHub 项目发布页，找到最新版的
nvm-setup.exe下载。
-
设置路径：
-
建议选择一个不含空格 的短路径作为安装位置（例如
D:\nvm）。 -
-
设置 Node.js Symlink（符号链接） 位置，这是 NVM 切换版本时生成的"虚拟快捷方式"。
这个配置是无关紧要的配置,可以直接默认
-
-
-
验证 ：打开命令行（CMD），输入
nvm version。如果显示出版本号，说明安装成功。
4. 关键配置：切换国内镜像源
默认情况下，NVM 从国外服务器下载 Node.js，速度极慢且容易失败。为了提升体验，强烈建议在安装后立即配置阿里云镜像。
以管理员身份运行命令行，执行以下操作：
-
方法一（命令行） ：
powershellnvm node_mirror https://npmmirror.com/mirrors/node/ nvm npm_mirror https://npmmirror.com/mirrors/npm/ -
方法二（修改文件） ：在 NVM 安装目录下找到
settings.txt，手动添加上述镜像地址。效果一样
5. 常用命令速查表
掌握以下命令，你就能轻松玩转 Node.js 版本管理：
| 功能 | 命令 |
|---|---|
| 查看在线可安装的版本 | nvm list available |
| 安装指定版本 | nvm install <version> (如 nvm install 18) |
| 查看已安装的版本 | nvm list 或 nvm ls (带 * 号为当前正在使用的版本) |
| 切换使用的版本 | nvm use <version> (需管理员权限) |
| 卸载指定版本 | nvm uninstall <version> |
6. 避坑指南与常见问题 (FAQ)
- 权限问题 ：执行
nvm use时若报错 "Access is denied"，通常是因为没有使用管理员身份运行终端。 - 全局包隔离 ：不同版本的 Node.js 下，其全局包（如
yarn,pnpm）是相互隔离的。这意味着你在 v18 下安装的全局工具，切换到 v20 后需要重新安装一次，这能有效保证环境纯净。 - 跨平台支持 ：除了 Windows，NVM 也支持 Linux 和 macOS 。在 Mac 上，建议使用
curl或wget脚本安装，注意不要使用 Homebrew，以免出现权限及配置问题。 - 安装版本 建议安装长期维护的版本(LTS),个人推荐18和20,大部分老项目是18,新项目20,个别会是16
总结
通过 NVM，我们可以将原本复杂的 Node.js 环境配置化繁为简。这就好比给你的电脑装上了一个"版本任意门"，无论是维护多年前的老项目，还是尝试最前沿的新技术，只需一行命令即可瞬间切换到对应的开发环境。