使用nvm安装和管理node.js

原创于 2025-07-07 14:02:03 发布 · 1.4k 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#node.js #arcgis

使用nvm安装和管理node.js

前言概览

Node.js 的更新迭代非常迅速，不同项目间常常需要搭配不同版本的 Node。为了避免频繁手动卸载、重装所带来的麻烦，你可以使用一个专门的版本管理工具——nvm（Node Version Manager），它可以：

🔄 轻松安装不同版本的 Node.js
💡 一句话就切换版本，无需 root 权限
❌ 避免旧版本残留和路径冲突

安装最新的 LTS 或者项目所需的精确版本都能轻松实现。本文基于windows实现nvm安装和nodejs的切换。

一、准备工作

之前没有下载过node.js的同学可以跳过这一步。

1.1 删除旧版本node.js

在**“设置 → 应用和功能”或者控制面板 -> 卸载程序 -> 卸载nodejs里卸载 Node.js。建议使用geek软件**删除。
运行命令：npm cache clean --force。
确认 node -v 或 npm -v 不再返回版本号。

1.2 删除残余路径

删除以下文件夹：

C:\Program Files (x86)\Nodejs
C:\Program Files\Nodejs
C:\Users{User}\AppData\Roaming\npm
C:\Users{User}\AppData\Roaming\npm-cache
删除C:\Users\用户名 下的 .npmrc文件以及 .yarnrc 文件
环境变量中npm、node的所有相关统统删掉

二、安装nvm

2.1 官网下载nvm

Releases · coreybutler/nvm-windows

2.2 安装 nvm-setup.exe

上面nvm和nodejs默认安装地址都是C盘，我们最好换成其他的盘。

并且注意安装路径的文件夹名称不要出现中文，空格等，否则后期npm使用的时候会出现符号格式不正确问题。

继续点击 Next 就行。

2.3 配置路径和下载镜像

安装完nvm后先不要着急安装node版本。

找到nvm安装路径 -> 找到 setting.txt 文件 -> 新增两行信息，配置下载源

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

增加后如下，然后保存退出(注意前面的不要动):

第一行是 nvm安装路径
第二行是 nodejs路径
第三行是 node下载镜像
第四行是 npm下载镜像

2.4 检查nvm是否安装完成

win + R，调用cmd，输入nvm，出现下面这一堆就表示安装成功了。

三、安装node

3.1 nvm安装指定node

win + R，调用cmd，查看node.js稳定版本

安装完成后开始插入nodejs首先使用 nvm list available 查询可插入版本号，LST表示可插入稳定版本。【如未指定版本，建议安装LTS下的版本】

安装指定node.js版本,未指定版本号默认下载最新版本

nvm install 22.15.0

检查安装是否成功

node -v

查看当前已经安装的node版本，带*是正在使用的

nvm list

删除指定版本node

nvm uninstall node 版本号

3.2 设置node镜像源

修改npm镜像源为淘宝镜像，加快npm包的下载速度，减少发生连接错误和超时的概率

npm config set registry https://registry.npmmirror.com

检查是否设置淘宝镜像成功（会返回这个地址表示成功：https://registry.npmmirror.com）

npm config get registry

3.3 切换其他版本nodejs

nvm use 切换node版本。(如果报错，用管理员身份打开重新 nvm use 你指定的版本）

nvm use 22.15.0

四、关于环境变量

4.1 nvm和node环境变量

nvm安装时会自动帮我们配置nvm和node的环境变量，如图所示。

同时这里变量已经写path中：

4.2 配置npm在安装全局模块时的路径和缓存cache的路径

默认情况下，npm 会把全局包安装到 %AppData%\Roaming\npm（默认的 prefix）和 %AppData%\Roaming\npm-cache（默认 cache）路径中。
修改prefix路径可以避免安装在系统目录（如 C:\Program Files）而导致权限不足的问题，尤其是在用户无管理员权限或 AV/策略限制 AppData 执行时
自定义 cache 路径能让缓存存储更稳定，也减少在共享目录/网络盘上的读写异常。

所以我们可以通过配置环境变量，修改这里安装全局模块的路径。

4.2.1 在nvm的node文件夹下新增两文件夹

4.2.2 npm配置prefix和cache路径

打开cmd命令行工具，执行操作（两个路径就是新建上面两个文件夹的路径，主要目的是方便后面window机器使用方便）

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

执行成功就无任何响应。

4.2.3 设置环境变量

进入环境变量对话框（直接搜索环境变量）
系统环境变量新增 NODE_PATH 变量

其中D:\tools\nvm\nodejs\node_global\node_modules 就是上面创建的全局模块安装路径文件夹，注意是原来global中的文件夹。
修改【用户变量】中的 path 变量