Windows 11 安装使用 nvm,Node.js、npm 多版本管理、切换
1. nvm 简介
背景:在日常的前端或 Node.js 开发中,我们经常会遇到不同的项目需要依赖不同版本的 Node.js 和 npm。直接安装和卸载版本来回切换非常麻烦,而且容易出错。为了解决这个问题,nvm(Node Version Manager)应运而生。
nvm 是一个用于管理多个 Node.js 版本的工具。它的主要功能包括:
- 版本安装:可以方便地安装多个版本的 Node.js(包括对应的 npm)。
- 版本切换:可以根据项目需求,在已安装的版本之间快速切换(全局或按目录)。
- 版本卸载:可以卸载任何不再需要的 Node.js 版本。
- 兼容性:完美解决不同项目因 Node.js 版本差异导致的兼容性问题。
对于 Windows 用户,我们使用的是 nvm-windows,这是原版 nvm(仅限 Mac/Linux)的一个独立分支项目。
项目地址:https://github.com/coreybutler/nvm-windows
2. 安装、配置 nvm
2.1. 卸载现有 Node.js(非常重要!)
在安装 nvm 之前,强烈建议先彻底卸载系统中已单独安装的 Node.js。否则可能会引起冲突,导致 nvm 无法正常工作。
请通过桌面下方任务栏中点击'开始'按钮(Windows 图标)->'设置'(齿轮图标)->'应用'->'安装的应用',搜索 'Node',如果有找到,点击右边的三个点,点击'卸载'。
2.2. 下载 nvm-windows 安装包
访问 nvm-windows 的项目发布页面 https://github.com/coreybutler/nvm-windows/releases 下载最新的 nvm-setup.exe 文件。
2.3. 安装 nvm
- 双击运行下载的
nvm-setup.exe。
- 桌面通知选项,都去除勾选,点击 'Next'。
- 填写 Node.js 的活动版本位置(此目录将自动添加到系统路径中),例如:
D:\soft\nodejs。
- 填写 nvm 的安装目录,例如:
D:\soft\nvm,点击 'Next'。
- 选择 'I accept …',点击 'Next' 完成安装。
2.4. 验证安装
桌面右击,点击'在终端中打开',将打开 PowerShell 终端,输入以下命令:
nvm version
如果正确输出了 nvm 的版本号(例如 1.2.2),则说明安装成功。
2.5. 配置镜像源
为了加速从网络下载 Node.js 版本,将镜像源设置为国内的淘宝镜像。
桌面右击,点击'在终端中打开',将打开 PowerShell 终端,输入以下命令:
nvm node_mirror https://npmmirror.com/mirrors/node/ nvm npm_mirror https://npmmirror.com/mirrors/npm/
3. Node.js、npm 多版本管理、切换
安装配置好 nvm 后,管理 Node.js 版本就变得非常简单。
桌面右击,点击'在终端中打开',将打开 PowerShell 终端。执行接下来的步骤:
3.1. 安装 Node.js 版本:24.8.0
# 列出所有可安装的版本
nvm list available
# 安装指定版本的 Node.js 24.8.0
nvm install 24.8.0
# 查看已安装的版本
nvm list
# 使用 Node.js 版本 24.8.0
nvm use 24.8.0
# 再次查看已安装的版本,*开头的是当前版本
nvm list
# 验证当前的 Node.js 版本
node -v
# 验证当前的 npm 版本
npm -v
3.2. 切换到 Node.js 版本:22.19.0
# 列出所有可安装的版本
nvm list available
# 安装指定版本的 Node.js 22.19.0
nvm install 22.19.0
# 查看已安装的版本
nvm list
# 使用 Node.js 版本 22.19.0
nvm use 22.19.0
# 再次查看已安装的版本,*开头的是当前版本
nvm list
# 验证当前的 Node.js 版本
node -v
# 验证当前的 npm 版本
npm -v
3.3. 为 npm 设置国内镜像源
# 设置新镜像源
npm config set registry https://registry.npmmirror.com
# 验证是否设置成功
npm config get registry
# 清理缓存:建议清理 npm 缓存,以避免旧缓存可能引发的问题
npm cache clean --force
4. 完整用法说明
nvm arch [32|64]: 显示 node 是否在 32 位或 64 位模式下运行。指定 32 或 64 可覆盖默认架构。
nvm debug: 检查 NVM4W 进程的已知问题。
nvm current: 显示当前版本。
nvm install <version> [arch]: 版本号可以是特定版本、"latest"表示最新版本,或"lts"表示最新的 LTS 版本。可选择指定安装 32 位或 64 位版本(默认为系统架构)。将 [arch] 设置为"all"以安装 32 位和 64 位版本。在命令末尾添加 --insecure 可跳过远程下载服务器的 SSL 验证。
nvm list [available]: 列出 node.js 的安装情况。在末尾输入 available 以显示可下载的版本列表。
nvm on: 启用 node.js 版本管理。
nvm off: 禁用 node.js 版本管理(不会卸载任何内容)。
nvm proxy [url]: 设置用于下载的代理。将 [url] 留空以查看当前代理。将 [url] 设置为 "none" 以移除代理。
nvm uninstall <version>: 卸载特定版本。
nvm use <version> [arch]: 切换到指定版本。可选择使用 latest、lts 或 newest。newest 是最新安装的版本。可选择指定 32/64 位架构。nvm use 将继续使用选定版本,但切换到 32/64 位模式。关于在特定目录中使用 use(或使用 .nvmrc)的信息,请参考 问题 #16。
nvm root <path>: 设置 nvm 应该存储不同版本 node.js 的目录。如果未设置,将显示当前根目录。
nvm version: 显示当前正在运行的 NVM for Windows 版本。
nvm node_mirror <node_mirror_url>: 设置 node 镜像。中国用户可以使用 https://npmmirror.com/mirrors/node/
nvm npm_mirror <npm_mirror_url>: 设置 npm 镜像。中国用户可以使用 https://npmmirror.com/mirrors/npm/