Windows 11 安装使用 nvm，Node.js、npm多版本管理、切换
Windows 11 安装使用 nvm，Node.js、npm多版本管理、切换
- 对应视频教程：
文章目录
1. nvm 简介
背景：在日常的前端或Node.js开发中，我们经常会遇到不同的项目需要依赖不同版本的 Node.js 和 npm。直接安装和卸载版本来回切换非常麻烦，而且容易出错。为了解决这个问题，nvm（Node Version Manager） 应运而生。本篇博客将详细介绍如何在 Windows 11 系统上安装、配置和使用 nvm，来轻松管理多个 Node.js 环境。
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 文件。
如果无法访问GitHub，也可选择国内下载：https://hanshuixin.org/go/222P
整合包（压缩包）内容：
Windows 11 安装使用 nvm，Node.js、npm多版本管理、切换.zip └── Windows 11 安装使用 nvm，Node.js、npm多版本管理、切换 ├── LICENSE ├── Windows 11 安装使用 nvm，Node.js、npm多版本管理、切换.pdf └── nvm-setup.exe 2.3. 安装 nvm
- 双击运行下载的
nvm-setup.exe。 - 桌面通知选项，都去除勾选，点击 “Next”
去除勾选，点击 “Finish”
点击 ”Install“，开始安装
接收通知邮箱，不用填，点击 “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 install24.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 install22.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/
