Dify+RAG行业问答机器人：从分块调参到生产部署全复盘
2026/10/10 3:43:13
NVM for Windows 是 Windows 平台专用的 Node.js 多版本管理工具，支持自由安装、切换、卸载任意 Node.js 版本，完美解决项目版本适配、版本冲突、手动升降级繁琐等痛点，是前端开发必备环境工具。
二、彻底卸载清理旧版 Node.js
步骤1：检测本地 Node 环境
1、按下Win+R，输入cmd打开命令提示符；
2、执行以下两条命令，判断是否存在旧版环境：
node -v npm -v✅ 提示「不是内部或外部命令」：无旧环境，跳过本章；
✅ 输出版本号：存在旧 Node，必须完整执行以下清理步骤。
步骤2：系统卸载 Node.js 程序
1、Win10 打开设置→应用→应用和功能，或 Win+R 输入appwiz.cpl打开控制面板程序列表；
2、搜索Node.js，选中程序点击【卸载】，跟随系统向导完成卸载；
3、卸载后暂不重启电脑，继续清理残留文件。
步骤3：手动删除全局残留目录（关键）
系统卸载仅删除主程序，会残留缓存与配置文件，以下路径存在即全部删除，无则跳过：
1、C:\Program Files\nodejs
2、C:\Program Files (x86)\nodejs
3、用户缓存目录：%AppData%\npm
4、用户缓存目录：%AppData%\npm-cache
💡 快捷操作：Win+R 直接粘贴路径，回车快速打开文件夹。
步骤4：清理 Node 相关环境变量
1、Win+R 输入sysdm.cpl打开系统属性；
2、切换【高级】选项卡 → 点击右下角【环境变量】；
3、分别进入用户变量、系统变量中的Path，删除所有包含nodejs、npm的路径；
4、全部保存设置，重启电脑确保清理完全生效。
步骤5：验证环境清理完成
重启电脑后，重新打开 CMD，再次执行：
node -v npm -v两条命令均提示「不是内部或外部命令」，代表旧环境彻底清理完毕，可开始安装 NVM。
二、下载官方 NVM 安装包
官方 Releases 下载地址：https://github.com/coreybutler/nvm-windows/releases
网盘下载地址: nvm-setup.exe
打开安装向导，勾选 I accept the agreement 同意开源协议，点击 Next；
设置 NVM 安装目录，禁止中文、空格、特殊符号路径，推荐安装在D盘，节省C盘空间，点击 Next；
设置 Node 软链接目录（NVM 版本切换映射目录），推荐路径同样是在安装的nvm路径里，例如D:\nvm\nodejs，后续所有 Node 版本统一在此管理，点击 Next；
后面就一直下一步开始安装即可,执行完成安装的目录包含如下内容。
三、验证 NVM 安装成功
✨ 关键操作：关闭所有已打开的 CMD、PowerShell 窗口，重新打开终端加载新环境变量。
终端输入验证命令：nvm -v，出现版本号表示安装成功
四、配置国内镜像源
默认国外镜像下载 Node/npm 极易超时失败，需配置淘宝镜像源，包含 NVM 下载镜像 + NPM 包下载镜像，两种配置方式任选。
方式1：命令行快速配置（推荐，即时生效）
# 设置 Node.js 下载镜像 nvm node_mirror https://npmmirror.com/mirrors/node/ # 设置 NPM 下载镜像 nvm npm_mirror https://npmmirror.com/mirrors/npm/方式2：修改配置文件永久生效
进入安装目录，找到settings.txt配置文件，记事本打开；在文件末尾追加以下配置，保存关闭：
node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/五、NVM 常用核心命令大全
| 命令 | 功能说明 |
|---|---|
nvm list available | 查看所有可在线安装的 Node 版本 |
nvm install 版本号 | 安装指定版本 Node（例：nvm install 18.20.4） |
nvm install lts | 安装最新长期稳定版 Node |
nvm list / nvm ls | 查看本地已安装的所有 Node 版本 |
nvm use 版本号 | 切换使用指定 Node 版本 |
nvm current | 查看当前正在使用的 Node 版本 |
nvm uninstall 版本号 | 卸载本地指定 Node 版本 |
nvm arch | 查看当前 Node 运行位数（32/64位） |
六、实操示例（快速搭建环境）
# 查看可安装版本 nvm list available # 安装18版本LTS稳定版 nvm install 18.20.4 # 切换使用该版本 nvm use 18.20.4 # 校验环境是否生效 node -v npm -v七、常见问题
Q：安装 NVM 前未卸载旧 Node，安装完成后 node、npm 全部不可用
彻底执行旧 Node 清理流程，完整卸载程序、删除残留文件夹、清空相关环境变量，重启电脑后重新操作即可恢复正常。
Q：全局安装 npm/cnpm 工具后，命令无法识别、使用失效
全局安装任意 npm 工具（cnpm、yarn、vue-cli 等）后，关闭所有终端窗口，重新打开 CMD/PowerShell即可正常调用命令。
Q：NVM 安装路径含中文/空格，导致切换版本失败、命令报错
卸载现有 NVM，重新安装至纯英文、无空格、无特殊符号路径，推荐路径：D:\nvm，避免后续所有兼容问题。
Q：nvm list available 空白、下载 Node 超时失败
确认已配置国内镜像，关闭系统代理、加速器、VPN，重新执行安装命令。
Q：安装/切换版本提示权限拒绝
全程以管理员身份运行终端和 NVM 安装程序。
Q：NVM 安装成功但终端无法识别命令
重启终端或电脑，让系统重新加载环境变量；检查安装路径合规性。
Q：nvm use 切换版本不生效，node -v 仍显示旧版本
90%为旧 Node 环境未清理干净，重新执行第二章完整清理步骤，重启电脑重试。