最近在维护公司老项目和开发新项目的时候,因为框架的问题老项目需要用低版本的 nodeJs 不然安装和编译过不了,然后新项目用的框架又用不了低版本的,以前都是直接用官方 msi 安装的,这样对我来说就很麻烦,然后我就发现这个 nodeJs 版本管理工具。看了一下没人写过完整的安装指南,那我就写(水)一篇

ps: 在我写这篇安装指南的时候看到有佬友发过可视化的版本( nvm-managernvm-Desktop),喜欢可视化的可以看看,NVM-Windows 是终端命令行的~

一、安装前准备

1. 卸载已有 Node.js

若已通过 MSI 安装过 Node.js,请先卸载:

  • 打开 控制面板 → 程序和功能

  • 找到 Node.js,右键卸载

  • 删除残留目录(如果存在):

    C:\Program Files\nodejs C:\Users\<你的用户名>\AppData\Roaming\npm 

重要:未卸载旧版会导致 nvm 无法正确接管 Node 环境 。

2. 准备安装路径

  • 创建无中文、无空格的目录用于安装 NVM,例如:

    D:\NVM 
  • 创建无中文、无空格的目录用于存放 nodeJs 相关的东西,例如:

    /**
    * nvm映射nodeJs的路径,这是能够指定版本的关键。映射之后里面会多出一个nodeJs的文件链接,指向指定的nodeJs版本文件夹
    */
    D:\nodeJs\execPath

    /*
    * * 缓存和全局包目录 */
    D:\nodeJs\node_cache
    D:\nodeJs\node_global

    /*
    * * 我们安装的各个nodeJs版本目录,比如我安装了 22.13.0 LTS 和 24.9.0 两个版本,就会 v22.13.0 和 v24.9.0 两个文件夹,nvm的文件夹链接就是链接到这里面的某个文件夹,实现多版本切换。 */
    D:\nodeJs\nodeJsPackage

路径含空格会导致 nvm use 命令失败


二、安装 nvm-windows

1. 下载安装包

访问官方 GitHub Release 页面:
Releases · coreybutler/nvm-windows · GitHub

  • 推荐下载nvm-setup.exe(图形化安装,自动配置环境变量)

2. 执行安装

  • 右键 → 以管理员身份运行 nvm-setup.exe
  1. 安装路径:D:\NVM(或你自定义的路径)

  2. 选择 NodeJs 链接路径,默认是 C:\nvm4w\nodejs,我们换成上面创建的 D:\nodeJs\execPath**(这里因为我已经安装过了,所以会显示链接路径出来,首次是没有的)** 然后点下一步

  3. 后面的看自己需要自行选择即可,最后点击 Install 完成安装

3. 验证安装

打开 新的终端窗口(必须重启终端),执行:

nvm version

若输出版本号(如 1.2.2),说明安装成功 。


三、关键配置

1. 配置镜像加速(国内必备)

编辑 D:\NVM\settings.txt(nvm 安装目录下),添加或修改:

root: D:\nodeJs\nodeJsPackage
path: D:\nodeJs\execPath\nodejs
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: http://mirrors.tencent.com/npm/

镜像源使用 npmmirror.com(原淘宝 NPM 镜像已停用)。


四、使用 nvm 管理 Node.js

常用命令

功能命令
查看可安装版本nvm list available
安装指定版本nvm install 24.10.0
安装 LTS 版本nvm install lts
切换版本nvm use 24.10.0(如果没有跟着上面的配置来的话需要管理员终端才能执行,因为默认映射的路径是 C:\Program Files\npm,微软要求操作 C:\Program Files 下的东西都需要管理员权限才能执行)
查看已安装版本nvm list

示例:安装并使用 Node.js 18

# 安装
nvm install 24.10.0

# 切换
nvm use 24.10.0

# 验证
node -v  # 输出 v24.10.0
npm -v   # 输出对应版本 

配置 npm 全局路径与缓存(仓库我选择了腾讯镜像,阿里有些包更新不及时。使用 pnpm 代替 npm)

npm config set prefix "D:\nodeJs\node_global"
npm config set cache "D:\nodeJs\node_cache"
npm config set registry http://mirrors.tencent.com/npm/
npm config set strict-ssl false

npm install -g pnpm

验证配置:

npm config list

配置系统环境变量

  • 用户变量 PATH 中添加:

    D:\nodeJs\node_global 
  • (可选)新建用户变量 NODE_PATH

    D:\nodeJs\node_global\node_modules 

此步骤确保全局命令(如 yarn, vue)可在任意终端使用 。


然后你就拥有一个了 多版本共存、无权限烦恼、下载飞快 的 Node.js 开发环境了!


📌 转载信息
原作者:
ExpOuter
转载时间:
2026/1/18 09:36:06

标签: Windows, NODE.JS, npm, NVM-Windows, Version Management

添加新评论