Windows下Node.js安装与配置的完全指南
作者：代码渡客
前言
Node.js 几乎是现代前端和后端开发绕不开的运行时环境。但很多新手在安装配置时容易踩坑——比如装完了命令行里却找不到 node、全局模块装完不知道去哪了、npm 下载慢得像蜗牛，等等。
本文将带你从零开始，完成 Node.js 在 Windows 上的安装、环境配置、镜像加速，以及常见问题的排查与解决。
一、什么是 Node.js
简单说，Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时，让你能在浏览器之外跑 JS 代码。
装好 Node.js 之后你会同时获得两个命令行工具：
node— 运行 JavaScript 的运行时npm— Node 包管理器，用来安装第三方库
二、下载安装包
版本选择
去 Node.js 官网 会看到两个版本：
| 版本 | 说明 | 推荐 |
|---|---|---|
| LTS（长期支持版） | 偶数大版本，稳定可靠 | 新手推荐 |
| Current（最新版） | 奇数大版本，功能最新但可能有坑 | 尝鲜用 |
截至 2026 年 6 月，推荐下载 v22.x LTS。
国内镜像加速下载
官网下载在国内有时候很慢，可以用国内镜像：
- 阿里云镜像： CNPM Binaries Mirror
- 腾讯云镜像： Index of /nodejs-release/
- 华为云镜像： Index of nodejs-local
选对应的大版本号（如 v22.20.0/），下载 node-v22.20.0-x64.msi 或 node-v22.20.0-x64.zip。
推荐下 .msi 安装包，图形化界面一路点就行。
三、安装步骤
3.1 运行安装程序
双击下载好的 .msi 文件，进入安装向导。
3.2 接受许可协议
勾选 "I accept the terms in the License Agreement"，点 Next。
3.3 选择安装路径
重点：不要用默认的 C 盘路径。
默认路径是 C:\Program Files\nodejs\，建议改到其他盘，比如：
D:\NodeJs\Node
这样做的好处：重装系统不怕丢、路径好记、方便排查问题。
3.4 选择安装组件
这里一般保持默认就行，所有组件都选中。特别注意：
- npm package manager — 必装
- Add to PATH — 必选，否则装完系统找不到 node 命令
3.5 自动安装工具（可选）
安装到最后一步会弹出一个复选框，问你要不要自动安装 Chocolatey 等额外工具。
勾掉，不需要。 直接点 Finish 完成安装。
四、验证安装
打开一个新的 PowerShell 或 CMD 窗口，依次输入：
node --version
预期输出类似：
v22.20.0
再验证 npm：
npm --version
预期输出类似：
10.9.0
如果两个命令都能正常输出版本号，说明安装成功了。
五、配置 npm
5.1 修改全局模块安装路径
npm 默认把全局模块装在 C 盘，C 盘空间宝贵，建议改到其他盘。
在 Node.js 安装目录（比如 D:\NodeJs\Node）下新建两个文件夹：
D:\NodeJs\Node\node_global ← 全局模块 D:\NodeJs\Node\node_cache ← 缓存
创建完毕后，复制刚刚创建的【node_global】和【node_cache】文件夹路径在cmd命令分别输入以下两条命令，注意不要两条命令的文件路径不要搞混了。
注：可以打开所创建的文件夹，把鼠标放在箭头指向的位置选择复制。
使用管理员身份打开cmd命令窗口，输入以下命令（下面的路径是我创建的文件夹所在的路径，需要复制你们自己创建的路径哦）
然后在命令行里设置：
#npm config set prefix “你的路径\node_global” #（复制刚刚所创建的“node_global”文件夹路径） npm config set prefix "D:\NodeJs\Node\node_global" #npm config set cache “你的路径\node_cache” #（复制刚刚所创建的“node_cache”文件夹路径） npm config set cache "D:\NodeJs\Node\node_cache"
5.2 把新的 global 路径加入 PATH
不然后续用 npm install -g xxx 装的全局命令会找不到。
打开"环境变量" → 在系统变量 Path 中：
- 把原来的
D:\NodeJs\Node\node_global之前的 npm 默认路径删掉（如果有的话），添加一条新记录：D:\NodeJs\Node\node_global(将默认的 C 盘下【AppData\Roaming\npm】修改成 【node_global】的路径) - 在【系统变量】中选择【Path】点击【编辑】后点击新建【%NODE_PATH%】
顺便把 D:\NodeJs\Node 也确认在 PATH 里。
5.3 配置淘宝镜像（国内必备）
npm 默认去 registry.npmjs.org 拉包，国内下载容易超时或极慢。换成国内镜像：
npm config set registry https://registry.npmmirror.com
验证是否生效：
npm config get registry
应该输出 https://registry.npmmirror.com。
如果想装 cnpm 命令行工具也可以（非必需）：
npm install -g cnpm --registry=https://registry.npmmirror.com
六、常见问题与解决
6.1 安装后 node 命令找不到
现象：
'node' 不是内部或外部命令，也不是可运行的程序
排查步骤：
- 确认
D:\NodeJs\Node已加入系统 PATH - 关掉当前命令行窗口，新开一个再试（环境变量不会自动刷新）
- 如果还不行，重启电脑
6.2 能找到 node 但无法运行
现象：
程序"node"无法运行: 找不到应用程序所在位置
或者用 where.exe node 看到输出类似：
C:\Windows\System32\node ← 一个假文件排在前面 D:\NodeJs\Node\node.exe ← 真正的 node
原因： C:\Windows\System32 里有一个叫 node 的 0 字节空文件（可能是某个程序卸载后的残留，或 Windows 应用执行别名），它在 PATH 中的搜索优先级比你装的 Node 高。
解决： 用管理员 PowerShell 删掉它：
Remove-Item C:\Windows\System32\node -Force
6.3 npm 全局安装的包找不到命令
现象： 比如执行 npm install -g yarn 成功，但敲 yarn 报找不到命令。
原因： npm 全局模块目录没在 PATH 里。
解决： 确认 D:\NodeJs\Node\node_global 已加入系统 PATH。
6.4 npm install 报权限错误（Error: EPERM）
现象：
Error: EPERM: operation not permitted
解决： 用管理员身份打开命令行再执行，或者前面已经配置了把全局路径改到 D 盘的话一般不会遇到这个问题。
6.5 安装时提示 2502 / 2503 错误
现象： 运行 .msi 安装包时报 2502 或 2503 错误。
解决： 用管理员身份运行安装包。右键 .msi 文件 → 以管理员身份运行。或者用管理员 CMD 执行：
msiexec /package "你下载的安装包路径.msi"
七、版本管理工具（进阶）
如果你需要在不同项目间切换 Node.js 版本，可以考虑装一个版本管理器：
- nvm-windows： https://github.com/coreybutler/nvm-windows
- fnm： https://github.com/Schniz/fnm （跨平台，更快）
装好 nvm 后可以自由切换版本：
nvm install 22.20.0 # 安装指定版本 nvm use 22.20.0 # 切换到指定版本 nvm list # 查看已安装的版本
总结
步骤不复杂，记住几个关键点：
- 去官网下 LTS 版本，网速慢就用国内镜像
- 安装路径别放 C 盘，记得勾选 "Add to PATH"
- 装完改 npm 的全局路径和缓存路径到非 C 盘
- 国内用户一定要配淘宝镜像，不然下载等到天荒地老
- 遇到
node命令诡异报错，先where.exe node排查是不是被假文件劫持了
以上就是Windows下Node.js安装与配置的完全指南的详细内容，更多关于Windows下Node.js安装与配置的资料请关注脚本之家其它相关文章！