Windows系统下Node.js环境部署指南：使用nvm管理多版本

一、Node.js介绍

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，用于开发高性能、可扩展的服务器端和网络应用程序。它采用事件驱动、非阻塞 I/O 模型，使其在处理高并发场景时表现出色，特别适合构建实时应用（如聊天工具）和数据密集型服务。Node.js 拥有庞大的生态系统，通过 NPM（Node Package Manager）提供了丰富的开源库和工具，极大地提升了开发效率。无论是构建 Web 服务器、API 接口，还是开发前端工具链，Node.js 都展现出了强大的灵活性和广泛的应用场景。

二、为什么需要nvm？

**Node Version Manager（nvm）**是专为Windows设计的Node.js版本管理工具，可解决以下痛点：

• 版本切换：不同项目依赖不同Node.js版本（如14.x用于老项目，20.x用于新项目）
• 权限控制：避免全局安装导致系统目录污染
• 快速回滚：一键切换稳定版/测试版，应对版本兼容性问题

三、安装前的准备工作

1. 本次环境说明

• 本次实践环境为Windows10 ，具体版本如下所示：

版本	Windows 10 专业版
版本号	22H2
安装日期	‎2021/‎5/‎1
操作系统内部版本	19045.5737
体验	Windows Feature Experience Pack 1000.19061.1000.0

2. 卸载现有Node.js（如有）

1. 控制面板 ➔ 卸载程序 ➔ 找到Node.js并卸载
2. 手动删除残留文件：
   • C:\Program Files\nodejs
   • C:\Users\你的用户名\AppData\Roaming\npm

三、nvm-windows安装步骤

1. 下载安装包

访问GitHub Releases，下载最新版nvm-setup.exe

2. 安装过程

1. 右键选择以管理员身份运行安装程序
2. 设置安装路径（建议使用默认C:\Users\用户名\AppData\Roaming\nvm）
3. 配置Node.js符号链接路径（建议C:\Program Files\nodejs）

3. 验证安装

打开新的CMD窗口，执行以下命令后，应显示版本号如1.1.12

nvm version 

---

四、使用nvm管理Node.js环境

1. 安装指定版本Node.js

nvm list available  # 查看所有可用版本
nvm install 20.14.0  # 安装LTS版本

2. 版本切换与使用

• 查看已安装版本

nvm list           

• 执行以下命令，启用nvm管理。

nvm on     

• 其余命令参考：

nvm use 20.14.0    # 切换到指定版本
nvm off            # 停用nvm管理

3. 配置镜像加速（针对国内用户）

在nvm安装目录下的settings.txt中添加，这里默认路径为C:\Users\admin\AppData\Local\nvm

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

4. 检查npm版本

• 检查Windows当前npm版本

npm -v

五、常见问题解决方案

1. nvm命令无效

• 检查环境变量：
  • NVM_HOME ➔ C:\Users\用户名\AppData\Roaming\nvm
  • NVM_SYMLINK ➔ C:\Program Files\nodejs
• 确保路径已添加到Path变量

2. 安装时报错Exit code 1

• 关闭杀毒软件/防火墙
• 清理缓存：

  nvm root clear
  

3. npm全局包路径冲突

修改npm全局安装路径：

npm config set prefix "C:\Users\用户名\npm-global"

并在环境变量Path中添加该路径

---

六、最佳实践建议

1. 项目级版本锁定
   在项目根目录创建.nvmrc文件：

   20.14.0
   

   执行nvm use自动切换版本

2. 多版本并行开发

   nvm install 18.19.1 --arch=x64  # 指定架构安装
   nvm use 18.19.1 && node app.js  # 运行旧版项目
   

3. 结合Docker使用（进阶）
   在容器中固定Node版本，避免环境差异：

   FROM node:20.14.0-alpine
   WORKDIR /app
   COPY package*.json ./
   RUN npm install
   COPY . .
   CMD ["node", "index.js"]
   

七、总结

通过本次实践，我们学习了如何在Windows系统下利用nvm有效地管理和切换多个Node.js版本，极大地方便了开发环境的配置与维护。过程中解决了诸如nvm命令无效和npm全局包路径冲突等常见问题，确保了Node.js环境的稳定运行。遵循最佳实践建议，可以进一步优化开发流程，提高工作效率，为项目的顺利进行奠定坚实基础。

---