这篇文章将 一步一步带你从 0 到 1 完成 Node.js Windows 开发环境配置,包括:
Node.js 安装
Windows 环境变量检查
npm 国内镜像源配置
npm 全局目录配置
Node 多版本管理(nvm)
适用于:
Windows 10
Windows 11一、下载 Node.js
访问官网:
Node.js
推荐下载:
LTS (Long Term Support)
Windows Installer (.msi)
64-bit版本说明:
二、安装 Node.js
下载完成后双击 .msi 文件安装。
安装流程:
Next
→ 同意协议
→ 选择安装路径
→ 保持默认组件
→ Install默认组件:
Node.js runtime
npm package manager
Add to PATH⚠ 必须勾选 Add to PATH,否则命令无法使用。
三、验证安装是否成功
安装完成后打开命令行:
Win + R
输入 cmd执行:
node -v
npm -v如果输出类似:
v20.x.x
10.x.x说明安装成功。
四、检查 Node.js 环境变量
一般安装程序会自动配置,但建议检查一次。
默认安装路径:
C:\Program Files\nodejs\检查步骤:
此电脑
→ 右键
→ 属性
→ 高级系统设置
→ 环境变量找到 系统变量 Path。
确认存在:
C:\Program Files\nodejs\如果没有:
新建 → 添加路径 → 保存重新打开命令行。
五、配置 npm 全局安装目录(强烈推荐)
npm 默认全局目录在:
C:\Users\用户名\AppData\Roaming\npm这个路径有几个问题:
路径太深
容易权限问题
不方便管理
建议创建目录:
D:\node_global然后执行:
npm config set prefix "D:\node_global"再把该目录加入 PATH:
D:\node_global这样所有全局工具都会安装到这里。
六、配置 npm 国内镜像源(解决下载慢)
npm 官方源在国外,安装依赖可能很慢。
查看当前源:
npm config get registry设置国内镜像:
npm config set registry https://registry.npmmirror.com镜像来自:
npmmirror
如果需要恢复官方源:
npm config set registry https://registry.npmjs.org官方仓库:
npm
七、使用 nrm 管理多个 npm 源(推荐)
可以使用 nrm 快速切换 npm 源。
安装:
npm install -g nrm查看源列表:
nrm ls切换源:
nrm use taobao八、企业院内 npm 源配置
很多公司会搭建私有 npm 仓库,例如:
https://npm.company.com设置方式:
npm config set registry https://npm.company.com如果需要登录:
npm login --registry=https://npm.company.com九、Node.js 多版本管理(推荐)
如果你需要:
不同项目使用不同 Node 版本
快速切换 Node 版本
建议安装:
nvm-windows
安装后使用:
nvm install 18.20.0
nvm install 20.11.0
nvm use 20.11.0优点:
同时管理多个 Node 版本
快速切换开发环境
⚠ 注意
安装 nvm 后不要再使用官方 Node msi 安装。
十、常见问题
1 node 不是内部或外部命令
原因:
环境变量未配置
终端未重启解决:
检查 PATH
重新打开终端2 npm 下载依赖很慢
解决:
切换国内镜像或者清理缓存:
npm cache clean --force3 npm 全局安装权限问题
不要使用默认路径。
建议配置:
npm prefix例如:
D:\node_global十一、推荐安装开发工具
安装常用 Node 包管理工具:
npm install -g pnpm
npm install -g yarn工具介绍:
pnpm:速度更快,占用更小
Yarn:经典包管理工具
总结
完整流程:
下载 Node
→ 安装 Node
→ 验证 node npm
→ 检查 PATH
→ 配置 npm 国内源
→ 配置 npm 全局目录
→ 安装 nrm
→ 安装 nvm完成以上步骤后,你的 Windows Node.js 开发环境就搭建完成了。