使用 nvm 安装与管理多版本 Node.js(Windows)

使用 nvm 安装与管理多版本 Node.js(Windows)

在实际开发中,不同项目可能依赖不同的 Node.js 版本。如何在同一台电脑上灵活切换?nvm(Node Version Manager)就是最佳方案。

一、什么是 nvm?

nvm 是 Node.js 的版本管理工具,可以让你在同一台机器上安装和切换多个 Node.js 版本,互不干扰。

为什么需要它?

  • 项目 A 需要 Node.js 16,项目 B 需要 Node.js 24 ------ 同时装不冲突
  • 想尝鲜新版本,又不想丢弃旧版本 ------ 随时切换
  • 全局包按版本隔离,避免依赖冲突

二、卸载已有的 Node.js

安装 nvm 之前,必须先卸载已安装的 Node.js,否则可能产生冲突。

打开终端,检查是否已安装:

bash 复制代码
node -v

如果输出了版本号,说明已安装,需要先卸载:

  1. 打开 控制面板 → 程序与功能
  2. 找到 Node.js,右键卸载
  3. 检查并删除以下残留目录(如果存在):
    • C:\Program Files\nodejs
    • C:\Users\<用户名>\AppData\Roaming\npm
    • C:\Users\<用户名>\AppData\Roaming\npm-cache

卸载完成后再次运行 node -v,确认提示"不是内部或外部命令"即可。


三、下载 nvm-windows

前往 nvm-windows 的发布页面下载安装包:

下载地址 :https://github.com/coreybutler/nvm-windows/releases

找到最新版本,下载 nvm-setup.exe 即可。


四、安装 nvm

4.1 运行安装程序

双击打开 nvm-setup.exe。

4.2 选择安装路径

建议安装到非系统盘,避免重装系统时丢失配置。例如:

复制代码
NVM 安装路径:D:\az\nvm
Node.js 路径:D:\az\nvm\nodejs

Node.js 的路径必须在 nvm 安装目录下,通常安装程序会自动填充,保持默认即可。

4.3 完成安装

一路点击 Next 直到安装完成。

4.4 查看环境变量

4.5 验证安装

bash 复制代码
nvm -v

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


五、配置镜像源(国内必做)

国内网络直接访问 nodejs.org 下载速度极慢甚至超时,因此需要配置淘宝镜像源。

5.1 找到配置文件

打开 nvm 安装目录下的 settings.txt,例如:

复制代码
D:\az\nvm\settings.txt

5.2 添加镜像配置

在文件末尾添加以下内容:

ini 复制代码
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/node/

配置完成后,后续安装 Node.js 就会从淘宝镜像下载,速度大幅提升。


六、安装 Node.js

6.1 查看可用版本

bash 复制代码
nvm list available

会列出所有可安装的 Node.js 版本。

6.2 安装目标版本

bash 复制代码
# 安装 Node.js 18 LTS
nvm install 18.19.0

# 安装 Node.js 24 LTS
nvm install 24.8.0

6.3 切换使用版本

bash 复制代码
nvm use 24.8.0

6.4 验证当前版本

bash 复制代码
node -v
npm -v

随时可以用 nvm list 查看已安装的所有版本,当前使用的版本前会有 * 标记。


七、配置 npm 全局路径

为了方便管理全局安装的包(如 TypeScript、pnpm 等),建议自定义 npm 的全局安装路径和缓存路径。

7.1 创建目录

在 nvm 目录下新建两个文件夹:

复制代码
D:\az\nvm\node_global   --- 全局包安装目录
D:\az\nvm\node_cache     --- npm 缓存目录

7.2 执行配置命令

bash 复制代码
npm config set prefix "D:\az\nvm\node_global"
npm config set cache "D:\az\nvm\node_cache"

7.3 配置环境变量

为了使全局安装的命令可以 anywhere 使用,需要将全局路径添加到系统环境变量:

  1. 打开 系统属性 → 高级 → 环境变量
  2. 在用户变量的 Path 中添加:D:\az\nvm\node_global
  3. 确认保存

八、常用命令速查表

命令 说明
nvm -v 查看 nvm 版本
nvm list available 查看可安装的 Node.js 版本
nvm list 查看已安装的版本
nvm install <版本号> 安装指定版本
nvm use <版本号> 切换到指定版本
nvm uninstall <版本号> 卸载指定版本
nvm current 查看当前使用的版本

总结

通过 nvm,你可以轻松实现多版本 Node.js 的共存与切换:

  1. 卸载原有 Node.js
  2. 安装 nvm-windows
  3. 配置淘宝镜像源
  4. 安装需要的 Node.js 版本
  5. 随时用 nvm use 切换版本

从此告别版本冲突的烦恼,专注于开发本身。


参考链接:

1.解决使用nvm命令报错

  1. nvm安装详细教程(安装nvm、node、npm、cnpm、yarn及环境变量配置)
相关推荐
木头左2 小时前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能2 小时前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
xx z20 小时前
directx修复工具下载(DirectX Repair 增强版 使用说明)
windows·系统·工具·软件
xx z1 天前
pcl2启动器下载(Minecraft PCL2 启动器 最新版 安装与使用说明)
windows·游戏·工具·软件
凯瑟琳.奥古斯特1 天前
我开源了一个 Windows 截图取字工具:全局热键 + 离线 OCR + 标注打码,不上传任何数据
windows·ocr
黑土豆1 天前
网页框一下就能截图Region-snap:我把这套功能封装成了 npm 包,支持 Vue 和 React
前端·javascript·npm
Funlang2 天前
在 Windows 95 上跑 Fun
windows
ö Constancy2 天前
一台电脑的硬件组成与作用:按功能分类详解(Windows 与 Linux 视角)
linux·windows·电脑
w3296362712 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔3 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs