这篇文章将 一步一步带你从 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

版本说明:

版本

说明

LTS

长期支持版本,生产环境推荐

Current

最新版本,适合体验新特性

二、安装 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 --force

3 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 开发环境就搭建完成了