Windows下Node.js与npm安装配置及镜像切换实战

脚本专家

在 Windows 开发环境中，Node.js 与 npm 的安装配置是前端工程化和 Node.js 后端调试的前置步骤。Node.js 基于 Chrome V8 引擎，采用事件驱动、非阻塞 I/O 模型，适合 Web 服务器、API、聊天应用等数据密集型实时场景；npm 是 Node.js 默认的包管理工具，负责依赖安装、版本管理和脚本运行。安装 Node.js 后 npm 会随之一并安装，通常不需要单独安装 npm。

一、安装前检查现有环境

打开命令提示符或终端，先执行版本检查命令：

2. node -v
3. npm -v

复制代码

如果能看到版本号，说明系统中已经存在 Node.js 和 npm，可以根据项目需要决定升级或重装；如果提示命令未找到，则按后续流程安装。这里的 -v 是 version 的简写，用于输出当前命令对应工具的版本。

二、Windows 下下载与安装 Node.js

Node.js 安装包可从 nodejs.org 的下载页面获取，原文给出的入口是 https://nodejs.org/en/download/。一般优先选择 LTS 版本，因为 LTS 是稳定版本；Windows 64 位环境可选择 Windows Installer（.msi）下的 64-bit 安装包。如果需要旧版本，可在 Previous Release 中查询，点击版本号进入对应下载界面。原文建议 Node.js 版本最好在 16 以上。

下载完成后双击 .msi 安装程序，按安装向导持续点击 next，最后点击 finish 完成安装。安装结束后，用 Win+R 打开运行命令框，输入 cmd 打开命令提示符，再执行：

2. node -v
3. npm -v

复制代码

如果两条命令都能显示版本信息，说明 Node.js 安装成功，npm 也已随 Node.js 安装完成。

三、npm 镜像查询与切换

在 Vue 等前端项目中经常使用 npm 安装依赖，而 npm 默认 registry 位于国外，直接下载可能较慢。原文给出的解决方式有两种。

方式一是使用 yarn 作为安装工具。先在 cmd 中检测 yarn 是否已安装：

2. yarn -v

复制代码

如果没有安装，可执行：

2. npm i -g yarn

复制代码

其中 i 是 install 的简写，-g 表示全局安装。安装完成后再次执行 yarn -v 检测。

方式二是修改 npm registry。先查询当前 npm 使用的镜像：

2. npm config get registry

复制代码

默认镜像为 https://registry.npmjs.org/。如果查询结果仍是该地址，可切换为国内镜像。原文列出的国内镜像包括 https://registry.npm.taobao.org/ 和 https://registry.npmmirror.com，并示例使用 npmmirror 提供的 https://registry.npmmirror.com。设置命令为：

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

复制代码

这条命令的作用是写入 npm 的 registry 配置，后续安装依赖时会按新地址请求包。镜像切换主要影响依赖下载环节，属于开发环境配置层面的性能优化。

四、安装结果验证与常见现象定位

安装和镜像配置完成后，可用长参数形式再次验证：

2. node --version
3. npm --version

复制代码

能够输出 Node.js 和 npm 对应版本号，即表明安装成功。排查时可以按顺序判断：先看 node -v 是否有版本输出，再看 npm -v 是否正常，随后用 npm config get registry 确认镜像地址是否符合预期。若命令提示未找到，说明当前环境尚未安装或命令不可用；若卸载后执行 node -v 提示“不是内部或外部命令”，按原文说明可视为旧版 Node.js 已卸载干净。

五、卸载与残留目录清理

需要卸载时，可打开控制面板中的程序和功能，或进入设置中的应用列表；也可以按 Win+R 输入 appwiz.cpl 回车，直接打开程序和功能窗口。找到 Node.js 后右键选择卸载。卸载完成后，检查并删除以下目录（如果存在）：C:\Program Files\nodejs、C:\Users\<用户名>\AppData\Roaming\npm、C:\Users\<用户名>\AppData\Roaming\npm-cache。随后在 CMD 中执行 node -v 做残留检查。

六、适用场景与配置注意点

这套流程适用于 Windows 下准备 Node.js 开发环境、配置 npm 依赖下载源、安装 yarn 以及重装或卸载后的清理检查。兼容性方面，原文以 Windows 64 位和 LTS 版本为主要安装路径，旧版本通过 Previous Release 获取，并建议 Node.js 版本不低于 16。需要控制的是 registry 地址和全局工具安装命令的使用范围：registry 决定 npm 包请求地址，npm i -g yarn 会将 yarn 安装为全局命令，卸载 Node.js 后还应按原文列出的目录清理 npm 全局与缓存残留。

热心网友1

楼主这篇写得很完整，从安装前检查、下载安装、镜像切换一直到卸载清理，整个流程串下来基本可以照着做。我补充几点自己踩过的坑，供参考。 第一，装完 .msi 之后一定要新开一个命令提示符窗口再执行 node -v 和 npm -v，之前开着的那个窗口环境变量还是旧的，很容易误以为安装失败。这也是很多人卡住的地方。 第二，验证环节楼主给出的排查顺序很实用，先 node 再 npm 最后 registry，一步一步往下排，比直接重装省事多了。 第三，镜像这块提醒一句，原文列的老 taobao 地址现在基本不太可用了，直接按楼主示例用 npmmirror 那个就行，别在旧地址上折腾。切换完用 npm config get registry 再确认一次是好习惯。 第四，卸载清理那部分很多人会忽略 AppData\Roaming 下的 npm 和 npm-cache 目录，残留不删干净，重装后全局包和缓存可能还会出奇怪问题，楼主专门列出来这点很到位。 另外关于版本，LTS 优先这个建议是对的，Node 16 以上现在也算基本门槛了，如果项目里用了更现代的工具链，建议直接上当前 LTS 的较新小版本，省得以后升级。 整体来说这套流程适合新手照着走，也适合老手做环境重装时当清单用，收藏了。

热心网友2

这篇整理得挺完整的，从安装前检查、Windows 安装、npm 镜像切换，到验证和卸载清理都覆盖到了，照着做基本能走通。比较实用的是把 node -v、npm -v、npm config get registry 这几个验证点单独列出来，排查时思路很清楚；卸载部分还提醒清理 AppData 下的 npm 和 npm-cache 残留，这点容易被忽略。镜像切换和全局安装 yarn 的说明也简洁，适合作为 Windows 环境配置的备忘。感谢分享。

热心网友3

这篇教程整体写得很完整，从安装前检查、Windows 安装、镜像切换，到验证、卸载和残留清理都覆盖到了，按顺序操作基本不会迷路。特别是把 node -v、npm -v、npm config get registry 这几个检查点分开讲，排查时很实用。 补充几个小提醒：国内镜像那段里，淘宝旧域名已经不太建议继续用了，优先用 npmmirror 那个地址会更稳妥；yarn 和切换 registry 是两条可选路线，不是必须都做，按项目习惯选一个就行。卸载清理时，AppData 目录默认是隐藏的，可以在资源管理器地址栏输入 %APPDATA% 快速进入，再检查 npm 和 npm-cache 目录。另外全局安装 yarn 时如果遇到权限问题，用管理员身份打开命令提示符通常能解决。整体来说这套流程适合作为 Windows 下 Node.js 环境配置的入门参考。