nvm-Windows 安装与使用教程

nvm-Windows 安装与使用教程

前言

不同的项目运行时可能需要不同的node版本才可以运行，由于来回进行卸载不同版本的node比较麻烦；所以需要使用node工程多版本管理。本人在配置时，通过网络搜索教程，由于文章时间过老，或者文章的互相拷贝导致配置时出现许多小问题，但最后也是配置成功了，想写下此文章帮助小伙伴们排除错误，节省各位宝贵的时间，如有问题欢迎留言讨论~

注意:安装nvm时不能安装任何node版本（如存在请删除后再安装nvm），再检查环境变量，如果还有node.js相关也删掉，保证系统无任何node.js 残留。
卸载完之后cmd命令行输入 node -v 查看是否还能查到node信息，无的话表示删除干净。

安装前准备

• 若已安装Node.js，需彻底卸载避免冲突

1.控制面板卸载：进入控制面板 → 卸载Node.js程序。
2.删除残留文件：

• 删除安装目录：C:\Program Files\nodejs（或自定义路径）
• 删除用户目录下的.npmrc文件：C:\Users\用户名
• 清理以下目录（若存在）：

C:\Program Files (x86)\Nodejs  
C:\Users\用户名\AppData\Roaming\npm  
C:\Users\用户名\AppData\Roaming\npm-cache

3.检查卸载结果：

node -v  # 若提示“找不到命令”则表示卸载成功

---

一、下载

1. GitHub 地址: DownLoad (适用于 Windows 系统)

2. 选择版本: 这里以 v1.1.11 为例。

   • nvm-noinstall.zip: 绿色免安装版本，使用前需要配置。
   • nvm-noinstall.zip.checksum.txt: 验证下载文件完整性的校验和文件。
   • nvm-setup.exe: EXE 安装版本，下载后点击安装，无需配置。
   • nvm-setup.zip: 安装包同上，只是使用了压缩，下载后点击安装，无需配置。
   • nvm-setup.zip.checksum.txt: 验证下载文件完整性的校验和文件。
   • nvm-update.zip: 用于更新 Node Version Manager (NVM) 的压缩包文件。
   • nvm-update.zip.checksum.txt: 验证下载文件完整性的校验和文件。
   • Source code(zip): ZIP 压缩的源码。
   • Source code(tar.gz): TAR.GZ 的源码，用于 Linux 系统。

3. 下载链接 (示例): 这里提供一个百度网盘链接 (仅供参考，请自行下载最新版本)。

   • 文件: nvm-setup-1.1.11.zip
   • 链接: DownLoad
   • 提取码: 1ifp

   ---

二、安装

1. 双击解压后的 EXE 文件 (nvm-setup.exe 或 nvm-setup.zip 解压后的 EXE)。
2. 选择"I accept the agreement" 并点击 “Next”
3. 选择NVM 的安装位置，选择好后点击 “Next”。
4. 选择Node.js 的安装位置，点击 “Next”。 记住你的 Node.js 路径！ 后面配置环境变量要用！
5. 准备安装，点击 “Install”。
6. 安装完成。

---

三、配置环境变量

1. 右击 “我的电脑”，选择 “属性”。
2. 点击 “高级系统设置”。
3. 点击 “环境变量”。
4. 在 “系统变量” 区里点击 “新建”。
5. 新建变量名为 NVM_HOME，变量值为你的 NVM 的安装目录，设置完成后点击 “确定”。
6. 新建变量名为 NVM_SYMLINK，变量值为你的 Node.js 的安装目录，设置完成后点击 “确定”。 注意：因为是第一次安装 NVM，里面可能没有任何 Node.js，所以你在安装目录时可能找不到 Node.js 文件。这时看下我们安装 NVM 时安装 Node.js 的路径就行，路径一致即可。
7. 找到 “系统变量” 下的 Path 变量，点击 “编辑”。
8. 添加 %NVM_SYMLINK% 和 %NVM_HOME%。 查看下有没有，没有的话就添加，有这两个就不管了，我的估计是安装的时候自动写入了，所以我这里进来就有。
   

---

四、配置镜像源

1. 打开安装目录下的 settings.txt 文件。
2. 在 TXT 文件里最后补充以下两行代码：

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

3. 保存退出。
   

---

五、测试安装与使用

1. 测试是否安装成功: Win + R 输入 cmd，打开命令框，输入 nvm -v，显示版本号即可。
2. 查看已安装的 Node.js 版本: nvm ls
3. 查看可以安装的所有 Node.js 的版本: nvm list available (这里并不是表示只能安装这些版本，有未写出来的版本，只是未展示出来)。
4. 安装指定版本 Node.js: nvm install 版本号， 例如：nvm install 16.20.0
5. 安装后，需要指定使用哪个版本的 Node.js: nvm use 版本号 ，例如：nvm use 16.20.0。 使用前可以先查看我们安装了哪些 Node.js 版本，然后指定使用。指定后，可再次查看 nvm ls，前面带 * 号的即为在用版本。
6. 查看当前 Node.js 版本: node -v
7. 查看当前 npm 版本: npm -v。

相关命令：

nvm list available    # 查看可下载的node版本
nvm install v    #下载node指定版本 v(版本号) 如:nvm install 20.11.1
nvm list    #查看已下载的node版本
nvm use v    #使用node指定版本 注:use指令需要使用管理员权限
nvm uninstall v #卸载指定版本 如:nvm uninstall 20.11.1

---

六、拓展问题（npm 安装提示：npm ERR! Unexpected token ‘.’）

该问题多半出现在使用nvm安装node的时候npm会出现错误。(此处暂时只提供win系统下的解决办法，其他系统的之后遇到会更重新)

• 首先打开cmd使用nvm卸载npm所属node和npm。
• 使用命令 nvm install node版本号 进行卸载。
• 点击链接DownLoad 找到你所需要的node版本的node压缩包然后下载。
• 在你安装nvm时选择的node目录路径下新建文件夹，命名方式为 v+node版本号
  

欢迎大家评论和留言！