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 全局与缓存残留。