Windows系统下 NVM 安装 Node.js 及版本切换实战指南

以下是 Windows 11 系统下使用 NVM 安装 Node.js 并实现版本自由切换的详细步骤：

一、安装 NVM（Node Version Manager）

1. 卸载已有 Node.js

如果已安装 Node.js，请先卸载：

• 控制面板 ➔ 程序与功能 ➔ 找到 Node.js，右键选择 卸载。
• 删除残留文件（如 C:\Program Files\nodejs 或 C:\Users\<用户名>\AppData\Roaming\npm）。

2. 下载 NVM for Windows

1. 访问 nvm-windows GitHub 发布页。
2. 下载最新版本的 nvm-setup.exe（如 v1.1.12）。

3. 安装 NVM

1. 运行安装程序：
   • 双击下载的 nvm-setup.exe。
   • 安装向导中：
     • NVM 安装路径：建议选择无空格的路径（例如 D:\Program\nvm）。
     • Node.js 安装路径：建议选择 D:\Program\nodejs（后续可修改）。
2. 配置镜像源（加速下载）：
   • 安装完成后，找到 NVM 的安装目录（如 D:\Program\nvm）。
   • 编辑 settings.txt 文件，添加以下两行：

     node_mirror: https://npmmirror.com/mirrors/node/
     npm_mirror: https://npmmirror.com/mirrors/npm/

4. 验证 NVM 安装

1. 以管理员身份运行 PowerShell 或 CMD：
   • 按 Win + S，搜索 cmd 或 PowerShell，右键选择 以管理员身份运行。
2. 输入以下命令验证：

   nvm --version

   • 若显示版本号（如 1.1.12），表示安装成功。

二、安装和切换 Node.js 版本

1. 查看可安装的 Node.js 版本

nvm list available

• 会列出所有可安装的版本（如 v14.21.3、v16.20.2、v18.20.4 等）。

2. 安装指定版本

以安装 v14.21.3 为例：

nvm install 14.21.3

• 安装过程中会自动下载并配置 Node.js 和 npm。

3. 切换 Node.js 版本

1. 查看已安装版本：

   nvm list

2. 切换版本：

   nvm use 14.21.3

      3.验证版本：                                                                                                   

node -v
npm -v

4. 设置默认版本

若希望每次打开终端时自动使用某个版本：

nvm alias default 14.21.3

三、项目级版本管理

1. 在项目目录中指定版本

1. 在项目根目录创建 .nvmrc 文件：

   echo 14.21.3 > .nvmrc

2. 进入项目目录并自动切换版本：

   nvm use

四、常用命令

五、注意事项

1. 权限问题：
   • 必须以 管理员身份运行 PowerShell/CMD，否则可能报错。
2. 环境变量：
   • NVM 会自动配置环境变量，无需手动设置。
3. 全局模块隔离：
   • 每个 Node.js 版本的全局模块（npm install -g）是独立的，切换版本后需重新安装。
4. 镜像源加速：
   • 如果下载速度慢，确保 settings.txt 中的镜像源已正确配置为国内源（如 npmmirror.com）。

六、常见问题

1. 安装失败？

• 原因：网络问题或镜像源未配置。
• 解决：
  • 检查 settings.txt 中的镜像源是否正确。
  • 尝试使用官方镜像：https://nodejs.org/dist/。

2. NVM 命令未识别？

• 原因：未以管理员身份运行终端。
• 解决：
  • 关闭当前终端，重新以 管理员身份运行 PowerShell/CMD。

3. 版本切换后未生效？

• 原因：未正确切换或环境变量冲突。
• 解决：
  • 确保使用 nvm use <version> 命令切换。
  • 避免手动修改系统环境变量 PATH。

七、实操示例

1. 安装 Node.js v14.21.3 和 v16.20.2：

   nvm install 14.21.3
   nvm install 16.20.2

2. 切换版本：

   nvm use 14.21.3  # 切换到 v14.21.3
   nvm use 16.20.2  # 切换到 v16.20.2

3. 设置默认版本：

   nvm alias default 14.21.3

通过以上步骤，你可以在 Windows 11 上轻松管理多个 Node.js 版本，并实现版本自由切换！如果需要进一步帮助，请随时提问。