1. 为什么需要Node.js和nvm？
作为一名全栈开发者，我经历过无数次Node.js环境配置的折磨。不同项目对Node版本的要求可能天差地别——去年用Node 14写的项目，今年用Node 18跑就可能报各种兼容性错误。更可怕的是，有些老项目还在用早已停止维护的Node 10。
这就是为什么我们需要nvm（Node Version Manager）。它就像Node.js的时光机，可以让你在多个版本间无缝切换。想象一下：早上用Node 20开发新项目，下午切回Node 14维护老系统，整个过程只需要一条命令。
2. Windows环境准备
2.1 系统要求检查
在开始之前，建议你的Windows系统满足以下条件：
- Windows 10 版本 1607 或更高（包括Windows 11）
- 至少2GB可用磁盘空间
- 管理员权限账户
注意：如果你之前安装过Node.js，建议先完全卸载。残留的旧版本可能导致各种诡异问题。
2.2 卸载旧版Node.js
按Win+R输入"appwiz.cpl"打开程序卸载界面，找到所有包含"Node.js"的项目彻底卸载。然后手动检查以下目录是否残留文件：
- C:\Program Files\nodejs
- C:\Users[你的用户名]\AppData\Roaming\npm
- C:\Users[你的用户名]\AppData\Roaming\npm-cache
3. 安装nvm for Windows
3.1 下载安装包
访问nvm-windows的GitHub发布页（https://github.com/coreybutler/nvm-windows/releases），下载最新版的nvm-setup.exe。截至2023年7月，稳定版本是1.1.10。
重要提示：绝对不要用管理员身份运行安装程序！这会导致后续权限问题。
3.2 安装过程详解
安装时特别注意这几个选项：
- 安装路径：建议保持默认的
C:\Users\[你的用户名]\AppData\Roaming\nvm - Node.js镜像：选择淘宝镜像（https://npm.taobao.org/mirrors/node/）加速下载
- 创建系统环境变量：务必勾选
安装完成后，以管理员身份打开新的命令提示符（cmd），输入：
nvm version如果显示版本号，说明安装成功。
4. 使用nvm管理Node.js
4.1 安装多版本Node.js
安装LTS版本和最新版：
nvm install 18.16.1 # 当前LTS版本 nvm install 20.5.0 # 最新稳定版查看可用版本列表：
nvm list available4.2 版本切换实战
切换到18.16.1：
nvm use 18.16.1设置默认版本（新开终端自动使用）：
nvm alias default 18.16.14.3 验证安装
检查Node.js和npm版本：
node -v npm -v5. 常见问题排雷指南
5.1 切换版本报错"exit status 1"
这是Windows系统常见问题，解决方法：
- 关闭所有终端窗口
- 重新以管理员身份运行cmd
- 执行
nvm use [版本号]
5.2 npm全局包丢失
nvm每个Node版本都有独立的全局包存储。建议：
- 在切换版本前备份全局包列表：
npm list -g --depth=0 > packages.txt - 切换后批量安装：
for /f %i in (packages.txt) do npm install -g %i
5.3 杀毒软件拦截
特别是360安全卫士可能会误报，建议：
- 安装时临时关闭实时防护
- 将nvm目录加入白名单
6. 高级配置技巧
6.1 镜像加速配置
在nvm安装目录下的settings.txt中添加：
node_mirror: https://npm.taobao.org/mirrors/node/ npm_mirror: https://npm.taobao.org/mirrors/npm/6.2 自定义安装路径
虽然不推荐，但可以通过修改环境变量实现：
- 新建系统变量NVM_HOME和NVM_SYMLINK
- 分别指向nvm安装目录和nodejs符号链接目录
6.3 与WSL配合使用
如果你同时使用Windows和WSL：
- 在WSL中安装Linux版nvm
- 共享相同的.npmrc配置
- 使用
ln -s创建软链接共享全局包
7. 日常使用最佳实践
- 项目级版本锁定：在每个项目根目录创建
.nvmrc文件，内容写如"18.16.1" - 自动切换：使用VS Code的"Auto Detect Node"扩展
- 定期清理：每季度运行
nvm list查看并删除不再使用的版本 - npm替代方案：考虑使用pnpm或yarn提升安装速度
我个人的工作流是：为每个大版本维护一个基础镜像（如16/18/20），然后基于这些镜像创建项目专用环境。这样既保持隔离性，又避免重复安装基础依赖。
