教程定位与前置说明

nvm（Node Version Manager）是一款专门用来在一台机器上同时管理多个 Node.js 版本的工具。
它的存在，几乎是前端/全栈开发里“必装”的利器之一。

想象一下：
不同项目依赖的 Node 版本各不相同，你又不想来回卸载重装。
有了 nvm，你只需要轻轻切换，就能立刻跑起来，不用折腾半天环境。

它能帮你：

• 多个项目并存：每个项目都能用自己的 Node 版本，互不干扰。
• 一键切换版本：LTS 稳定版、Current 最新版来回跳。
• 维护老项目：排查环境差异、还原历史版本更轻松。
• 团队协作稳定：避免“我这能跑、你那报错”的环境地狱。

安装与环境准备（Windows）

在使用 nvm 之前，先把环境打理干净，这是避免后续出错的关键。尤其是之前装过 Node.js 的情况，一定要彻底清理，否则容易出现路径冲突或版本混乱。

下载安装包

首先，前往 nvm-windows 的官方仓库，下载对应的 .exe 安装包。
建议直接选择最新的稳定版本，避免后续更新带来兼容性问题。

自定义安装目录

安装过程中会要求指定两个目录：

• nvm 安装目录（例如 C:\nvm）
• Node.js 安装目录（例如 C:\nodejs）

这两个路径建议在第一次安装时就确定好，不要频繁更改。保持路径稳定，能避免很多不必要的麻烦，也方便后续版本切换和维护。

清理旧 Node 环境

如果你的系统之前已经装过 Node.js，需要先把旧环境完全移除，避免与 nvm 发生冲突：

1. 卸载旧版 Node.js。
2. 打开系统环境变量，删除旧的 Node 路径。
3. 完成 nvm 安装后，重启终端，让 PATH 配置生效。

首次上手

安装完成后，第一步就是确认 nvm 是否已经被系统正确识别。这一步非常关键，它决定后面的一切操作是否顺畅。

检查是否安装成功

nvm --version

• 能输出版本号，就说明 nvm 安装和环境变量配置没问题。
• 如果报错，多半是 PATH 没生效，重启终端或重新检查配置。

查看可用的 Node.js 版本

nvm ls           # 查看本地已安装的版本
nvm ls-remote    # 查看远程可安装的版本

nvm ls-remote 会列出官方可安装的版本，方便你直接挑选合适的版本进行安装。

安装与切换 Node.js 版本

nvm install --lts           # 安装最新 LTS 稳定版
nvm use 20.11.1             # 切换到指定版本
nvm alias default 20.11.1   # 设为默认版本

• --lts 表示安装长期支持版本。
• 切换版本后，建议重启终端，避免环境残留导致命令不生效。

验证 Node 与 npm

node -v
npm -v

• 输出的版本号应与刚才安装的一致。
• 如果仍显示旧版本，说明 PATH 顺序有冲突，需要检查环境变量配置。

最小闭环演练

接下来是一条从“装 nvm”到“跑项目”的完整闭环流程。跟着做一遍，环境基本就稳了。

安装 nvm-windows

nvm --version

确认 nvm 已正常可用。

安装 Node LTS 版本

nvm install --lts
nvm use --lts
nvm alias default <LTS版本号>

将 LTS 版本设置为默认版本，方便后续自动使用。

初始化项目

mkdir wolfpack-demo
cd wolfpack-demo
npm init -y

此时的 Node 版本应为刚刚设定的默认 LTS 版本。

写入 .nvmrc 文件

在项目根目录新建 .nvmrc 文件，内容为：

20.11.1

通过 .nvmrc 文件标记项目所需的 Node 版本，方便团队成员统一开发环境。

切换其他版本测试

nvm install 18.19.0
nvm use 18.19.0
node -v

确认版本切换生效。

切回默认版本

nvm use default
node -v

验证是否成功回到默认版本。

运行项目

npm run dev
npm run build

确保项目能在不同版本下正常运行。这一步的意义在于确认环境切换不会对项目造成影响，也为后续多项目共存打下基础。