很多前端、后端新手入门开发的第一步，就是搭建本地 Node.js 环境。不管是运行 Vue/React 项目、使用 npm/yarn 安装依赖，还是执行各类前端构建工具，都离不开 Node.js。
不少同学安装时容易踩坑：选错版本、环境变量配置失败、npm 下载卡顿报错、安装后命令不生效等。今天给大家整理一套Windows 10/11 通用、零报错、零基础可上手的 Node.js 完整安装配置教程，全程傻瓜式操作，看完一次性搞定环境！
一、先搞懂：该装哪个版本？
Node.js 官网提供两个主流版本，新手和日常开发优先认准 LTS 长期稳定版，坚决不盲目装最新版：
- LTS 版本（推荐）：长期支持版，稳定性极强，BUG 少，适配绝大多数项目，适合学习、开发、生产环境使用
- Current 版本：最新尝鲜版，包含最新特性，但兼容性差、稳定性不足，仅适合技术测试，不适合日常开发
✅ 结论：所有 Windows 开发者，统一安装 64 位 LTS 版本
二、第一步：官方下载安装包
为了避免捆绑软件和安装包篡改，务必从官方网站下载，安全无后门。
官网地址：https://nodejs.org/
1、打开官网后，首页会自动适配 Windows 系统，直接点击下载 Windows Installer (.msi) 64位 LTS 安装包
2、无需手动选择系统版本，现在主流 Windows10/11 均为 64 位，直接下载默认安装包即可
3、等待安装包下载完成（文件不大，网速正常几十秒即可完成）
三、第二步：傻瓜式安装（关键细节避坑）
本次以 Windows11 为例，Windows10 操作完全一致，全程只需点击下一步，重点注意1个核心设置！
1、双击下载好的.msi 安装包，弹出用户账户控制提示，点击「是」允许修改设备
2、进入安装向导，点击「Next」，勾选同意用户许可协议，继续「Next」
3、自定义安装路径（重要）：默认是C盘路径，建议新手可以默认安装；想要节省C盘空间的同学，可修改到D盘等非系统盘，路径绝对不要包含中文、空格、特殊符号，避免后续命令报错
4、组件选择页面：保持默认全部勾选，系统会自动配置 Add to PATH（添加到环境变量），这是最关键的一步，无需手动配置环境变量，安装后即可全局使用 node、npm 命令
5、高级选项页面：无需勾选「自动安装必要工具」，避免额外安装无用的VS编译组件，直接下一步
6、最后点击「Install」开始安装，等待1-3分钟，点击「Finish」完成安装
四、第三步：验证安装是否成功
安装完成后必须验证！很多时候看似安装成功，实则环境未生效，导致后续无法使用。
1、快捷键 Win + R，输入 cmd 打开命令提示符（PowerShell 也可以）
2、依次输入两条命令，查看版本号，输出版本即代表安装成功
# 查看 Node.js 版本
node -v
# 查看 npm 版本（Node.js 自带npm，无需单独安装）
npm -v💡 正常效果：终端会输出版本号（如 v20.x.x、v10.x.x），无报错、无不是内部命令提示即为成功。
❌ 报错提示「不是内部或外部命令」：大概率是安装时未勾选环境变量，或未重启终端，关闭cmd重新打开重试即可。
五、进阶优化：配置淘宝镜像（解决下载慢、超时）
默认 npm 源为国外服务器，国内下载依赖极易卡顿、超时、安装失败。新手必做一步：切换国内淘宝镜像源，速度提升几十倍。
在 cmd 中执行以下命令，全局配置淘宝镜像：
npm config set registry https://registry.npmmirror.com验证镜像是否配置成功：
npm config get registry返回 https://registry.npmmirror.com 即配置完成，后续安装所有依赖均为国内高速下载。
六、新手必备：常用基础命令
安装配置完成后，分享几个日常开发最常用的 npm 命令，新手直接收藏：
# 初始化项目（生成package.json配置文件）
npm init -y
# 安装项目依赖
npm install 包名
# 全局安装工具
npm install 包名 -g
# 卸载依赖
npm uninstall 包名
# 查看npm配置
npm config list七、常见报错 & 解决方案
1、’node’ 不是内部或外部命令
原因：环境变量未生效或安装时未勾选Add to PATH。解决方案：关闭所有终端重新打开，依旧报错则重新运行安装包修复安装。
2、npm 安装依赖超时、网络错误
原因：默认国外源网络差。解决方案：重新执行上方淘宝镜像配置命令，切换国内源即可解决。
3、安装路径含中文导致报错
原因：路径存在中文、空格、特殊字符。解决方案：卸载重装，使用纯英文无空格路径安装。
八、写在最后
Node.js 是前端工程化、后端开发的基础环境，安装配置看似简单，却是很多新手入门的第一个踩坑点。按照这套教程操作，全程零手动配置环境变量、零复杂操作，一次性搭建好稳定可用的开发环境。
后续不管是学习 Vue、React、Vite，还是开发 Node 后端项目，这套环境都可以完美适配，放心使用！
如果安装过程中遇到其他报错，欢迎评论区留言交流～
