【2026最新】NVM安装使用保姆级教程|告别Nodejs版本冲突,新手必看!

NVM 是用于管理电脑本地 Node.js 运行环境的轻量级命令行工具,能兼容电脑上所有的 Node.js 版本。

有了 NVM,只要输入一行简单的命令,那么使用哪个版本的 Node.js 就可无缝切换到哪个版本的 Node.js,彻底解决掉 Node 版本冲突的问题。

NVM 免费且开源,代码公开,安全有保障,个人和企业完全能作为商业用途使用。原生 NVM 适配 Windows、 MacOS、 Linux 系统,支持所有主流开发设备的使用。

和同类型的软件相比,NVM 的优势非常明显:

对比维度NVMnfnmVolta
支持平台macOS、Linux、Windows(nvm-windows)仅 macOS、LinuxmacOS、Linux、WindowsmacOS、Linux、Windows
开发语言Shell 脚本Shell 脚本RustRust
启动速度较快极快(Rust 编译优势)极快
核心定位全局多版本管理与灵活切换简单的版本切换快速版本切换项目级工具链锁定
社区生态历史最悠久,教程和踩坑指南极其丰富相对较小较活跃,但资源不如 NVM较活跃,偏企业级用户
上手难度低,对新手友好中等中等偏高
项目级支持支持.nvmrc文件自动识别版本不支持支持原生支持,是其核心卖点
全局管理灵活性非常灵活,可随意安装/卸载/切换任意版本较灵活较灵活偏向自动化管理,手动干预较少
推荐人群所有开发者,尤其是新手和跨平台用户macOS/Linux 用户,追求极简追求极致速度的进阶用户企业团队,注重项目一致性

总的来看,NVM 在兼容性和功能稳定性上明显比其他同类软件要更好,是当今最优秀的 Node.js 版本管理工具。

下载NVM(2026最新)

最新版 NVM 安装包下载地址:https://pan.quark.cn/s/3feabe8704f3

nvm-setup.exe:适配 Windows 系统

安装NVM

以 Windows 系统安装 NVM 为例

  1. 右键“nvm-setup.exe”安装包以管理员身份运行:

  1. 选择“I accept the agreement”点击“Next”:

  1. 工具默认装在 C 盘,点击“Browse”更改安装目录:

  1. 改到 D 盘,点击“Next”:

  1. nodejs 默认也在 C 盘下,点击“Browse”进行更改:

  1. 改到 D 盘,点击“Next”:

  1. 点击“Next”:

  1. 点击“Next”:

  1. 点击“Install”:

  1. 点击“Finish”:

  1. 打开命令提示符窗口,输入命令nvm - v敲回车显示版本号即为安装成功:

提示:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash:适配 Mac / Linux 系统(均以该命令行的方式下载和安装)

使用NVM

  1. 查看可用的 Node 版本:

  1. 安装稳定版的 Node:

  1. 查看已安装的 Node 版本:

  1. 安装指定版本的 Node:

  1. 切换 Node 版本(需要当前 Node 正在使用):

  1. 卸载指定版本的 Node:

NVM注意事项和常见问题

使用注意事项
  1. 安装路径不要有中文、空格以及特殊符号,否则导致环境变量失效、命令无法识别等问题;
  2. 使用“管理员身份”打开终端,避免权限不足导致报错;
  3. 安装 NVM 前,建议卸载电脑上的 Node.js,避免环境冲突;
  4. 不要经常切换 Node 版本,建议优先用 LTS,更加稳定。
常见问题和解决办法
  1. 提示nvm: command not found
    原因:环境变量未生效。
    解决:检查~/.bashrc~/.zshrc文件内是否包含 NVM 的加载脚本,再执行 source 命令刷新。

  2. Windows 下 nvm use 失败?
    Windows 的 NVM 在切换版本时需修改系统的软链接,所以务必要“以管理员身份运行 CMD 或 PowerShell ”。

  3. 无法卸载当前正在使用的版本?
    NVM 不允许卸载当前激活的 Node 版本。先用nvm use <其他版本>切换后,再执行nvm uninstall <目标版本>

  4. 提示 Node 版本切换成功,但项目依旧报错?
    关闭项目终端和编辑器,重启。删除项目里的 node_modules 依赖包,重新安装依赖。

  5. Node 下载失败?
    配置国内的镜像源,重新执行安装命令。

总结

NVM 作为免费的跨平台工具,有着轻量高效、多版本共生、环境隔离和全场景适配的众多优势,是实用性最高的 Node 版本管理利器。