Node.js安装及配置_基于NVM管理Node版本

前言

传统方法，官网下载Node，安装使用，缺陷是只能安装一个版本，本次是基于NVM管理Node版本，可以通过NVM自主选择多个Node的版本使用

Node.js网址：https://nodejs.org/en/download

推荐用阿里： 阿里云的 node 镜像

这是安装单一Node的方法，可以参考之前的文章：Node.js安装及配置

1. 卸载历史Node

控制面板卸载Node.js后，进入到安装目录，比如：D:\Software\nodejs，清空此文件夹，删除系统变量和环境变量，如下

遇到 workspace 清空占用的，可以通过 lObit Unlocker 解除占用后删除

2. NVM 安装

下载 nvm-windows：https://github.com/coreybutler/nvm-windows/releases

安装 nvm-setup.exe ，安装路径选择 D:\Software\nvm，切记不能将 NVM 和 nodejs 位置放一个文件夹！切记切记！

提示文件夹已存在，是否仍安装，因为这里已经提前建好了 nvm 文件夹，所以选择是即可

Node.js的活动版本位置，这里选择位置 D:\Software\nodejs

桌面通知是否接收，只选择第一项：Node.js LTS （稳定版）然后直接下一步

邮箱地址可接受更新通知，可选项，这里不选直接下一步

准备安装，检查目标安装位置无误后，点击 Install 开始安装

安装完成

会通过 PowerShell 打开

这里关掉即可

3. 配置路径

安装完成后，不着急安装 Node ，找到 NVM 安装路径，找到 settings.txt 文件

配置 Node 和 npm 下载镜像

root: D:\Software\nvm
path: D:\Software\nodejs
node_mirror:https://npmmirror.com/mirrors/node/
npm_mirror:https://npmmirror.com/mirrors/npm/

4. 检查 NVM 是否安装完成

打开 CMD 命令行窗口，输入nvm，出现如下就表示安装成功了。

5. NVM 管理 Node 源

先通过 nvm list available 查询可下载版本号，LST表示可插入稳定版本。【如未指定版本，建议安装LTS下的版本】，这里只列举了一部分，完整列表，可访问：https://nodejs.org/en/download/releases

nvm list available

这里下载 24.14.1 最新的稳定版

nvm install 24.14.1

这里提示：error installing 24.14.1: Node.js v24.14.1 is not yet released or is not available for download yet.意思是：列表里显示 24.14.1 是最新的 LTS，但 实际在运行命令的这一刻，Node.js 官方还没把 24.14.1 的完整安装包上传好（或者 nvm 的下载链接还没更新）。

最简单有效的方法

# 直接安装最新的 LTS（nvm 会自动选当前可用的最新稳定 LTS）
nvm install lts
# 或者安装当前的 Current 版本（推荐用于 openclaw）
nvm install latest

其他实用命令：

• nvm install 24 → 安装 24.x 系列的最新可用版本（不用写完整小版本号）
• nvm install 24.14.0 → 尝试稍早一个 patch 版本（通常已经稳定可用）
• nvm install 22 → 如果想保守一点，用上一个 LTS（22 系列目前也很稳定）

先临时切换回官方源

nvm node_mirror https://nodejs.org/dist/
nvm npm_mirror https://registry.npmjs.org/

这里先使用阿里最新的镜像 Node.js v24.9.0

nvm use 24.9.0        # 或 nvm use 24 或 nvm use lts
nvm on				  # 开启 nvm 打开nodejs版本控制
node -v
npm -v

列出 NVM 当前管理的 Nodejs 版本列表

D:\Software\nvm>nvm ls

    24.14.1
  * 24.9.0 (Currently using 64-bit executable)

D:\Software\nvm>

通过 nvm install lts 和 nvm use x.x.x 后，系统变量和环境变量自动添加

NVM_HOME
D:\Software\nvm

NVM_SYMLINK
D:\Software\nodejs

%NVM_HOME%
%NVM_SYMLINK%

nvm-windows 的工作原理是：

• 把不同版本的 Node 安装在 nvm 自己的目录下（通常是 %APPDATA%\nvm\v24.x.x）。
• 然后用 符号链接（symlink） 把 NVM_SYMLINK 指向的路径（默认或设置的 D:\Software\nodejs）“伪装”成当前使用的 Node 版本

6. 配置仓库和缓存目录

过去安装 nodejs ，需要单独新建 node_global 和 node_cache两个文件夹，还需要在新建的 node_global 文件中再新建 node_modules 文件夹，现在 NVM下载的新版本 Node 已经自动创建好这三个文件夹

接下来，命令行配置仓库和缓存地址即可
但通过获取仓库和缓存的位置可以发现，NVM也已经把这些配置好了

npm config get prefix
npm config get cache

传统做法会执行如下命令配置仓库和缓存地址

npm config set prefix "D:\Software\nodejs\node_global"
npm config set cache "D:\Software\nodejs\node_cache"

通过获取配置可发现地址是自行设定的，但是如此就必须在环境变量的Path中添加对应路径

但如果使用 NVM 提供的默认地址，便可不必配置 Path 变量路径
如果使用了自定义的仓库路径和缓存地址，又未配置 Path 变量，可能出现下载了包但依旧找不到

解决方法就是可以通过如下命令删除自定义的配置

npm config delete prefix
npm config delete cache

7. NRM 管理 NPM 源

有关镜像源的切换配置，详情可见这篇文章⬇️

NRM：快速切换 npm 镜像源的管理工具指南

安装 NRM ，命令：npm install -g nrm

npm install -g nrm

验证版本

列出可用的源：当前配置的所有可用 npm 源以及它们的名称和 URL

将当前的 npm 源切换为指定的源，比如淘宝的镜像源

测试镜像源的速度

显示当前使用的源

8. 安装 cnpm

npm install -g cnpm

问题

1. 在安装 nvm 之前没有卸载掉 node，导致 nvm 安装完之后，node和npm都不可用。所以我们在拿到一个新电脑时候最好是先下载nvm，再安装node版本。
2. 在第一次使用nvm安装node后，记得使用 nvm use 切换下node版本，以及用 nvm on 打开nodejs版本控制，不然这时候node和npm也都不可用。
3. 使用 淘宝镜像 https://registry.npm.taobao.org 报错的问题，因为淘宝原镜像域名（registry.npm.taobao.org）的 HTTPS 证书正式到期； npm 淘宝镜像已经切换到了registry.npmmirror.com，使用命令行重新切换就可以了 npm config set registry https://registry.npmmirror.com，文章链接：技术资讯：npm 淘宝镜像正式到期，赶紧更新！
4. 出现报错 无法将“node.exe”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。（1.确保已经安装好nodejs 2. 环境变量配置成自己的路径，尝试修改路径配置） 这个也可参考评论区
5. 想要知道node、npm安装位置可以使用命令行 where node、where npm

9. 终极版命令【熟悉步骤直接用】

9.1 NVM 安装的路径

D:\Software\nvm

9.2 NVM 配置的 Nodejs 的路径

D:\Software\nodejs

上述两个是在安装 NVM 时就设置好的，下面是 NVM 安装完成后，配置的命令

9.3 NVM 下载 Nodejs 的镜像源配置

9.3.1 设置 Node.js 官方源（推荐）

nvm node_mirror https://nodejs.org/dist/

9.3.2 设置 npm 官方源

nvm npm_mirror https://registry.npmjs.org/

9.3.3 如果选淘宝镜像

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

9.4 安装 Nodejs

可用 Nodejs 版本

nvm list available

下载 Nodejs

nvm install 24

或者

nvm install 16.20.2

使用 Nodejs【重要！！！】

nvm use 24.9.0

列出 NVM 已经下载管控的 Nodejs 版本

nvm list

9.5 NRM 下载 NPM 的镜像源

全局下载 NRM

npm install -g nrm

列出可用的 npm 镜像源

nrm ls

使用淘宝镜像源

nrm use taobao

测试镜像速度

nrm test

9.6 NPM 下载 CNPM

全局下载

npm install -g cnpm