【Windows】Node.js 解压版安装与环境变量配置(超详细图文教程)
Windows 安装解压版 Node.js(超详细教程)
前言
在 Windows 环境下安装 Node.js 通常有两种方式:
- 安装版(.msi)
- 解压版(.zip)
对于开发人员来说,解压版更加灵活:
- 无需管理员权限
- 绿色安装,删除目录即可卸载
- 方便维护多个 Node.js 版本
- 适合离线环境部署
本文以 Windows 10/11 为例,介绍如何安装并配置解压版 Node.js。
一、下载 Node.js
1. 访问官网
Node.js 官方网站:
https://nodejs.org
进入官网后可以看到两个版本:
| 版本 | 说明 |
|---|---|
| LTS(Long Term Support) | 长期支持版,推荐生产环境使用 |
| Current | 最新功能版,适合尝鲜 |
建议选择:
✅ LTS 版本
2. 下载 ZIP 压缩包
进入对应版本下载页面后,下载:
node-vxx.x.x-win-x64.zip
例如:
node-v22.17.0-win-x64.zip
二、解压 Node.js
将压缩包解压到固定目录,例如:
D:\dev\nodejs
目录结构如下:
D:\dev\nodejs
├── node.exe
├── npm
├── npx
├── node_modules
├── ...
说明:
- node.exe:Node.js运行环境
- npm:Node包管理器
- npx:Node命令执行工具
三、配置环境变量
1. 打开环境变量
操作路径:
此电脑
↓
属性
↓
高级系统设置
↓
环境变量
2. 配置 Node.js 路径
在系统变量 Path 中新增:
D:\dev\nodejs
例如:
Path
├── D:\dev\nodejs
保存即可。
四、配置 npm 全局目录(推荐)
为什么要配置?
默认情况下 npm 会把全局安装的包放到:
C:\Users\用户名\AppData\Roaming\npm
缺点:
- 路径较深
- 不方便备份
- 多版本 Node 管理困难
建议统一放到 Node.js 目录下。
1. 创建目录
在 Node.js 目录中新建:
D:\dev\nodejs\node_global
D:\dev\nodejs\node_cache
目录说明:
node_global
└── npm全局安装包
node_cache
└── npm缓存文件
2. 配置 npm
打开 CMD 或 PowerShell:
npm config set prefix "D:\dev\nodejs\node_global"
npm config set cache "D:\dev\nodejs\node_cache"
查看配置:
npm config list
或者:
npm config get prefix
npm config get cache
五、配置全局模块环境变量
继续编辑系统变量 Path。
新增:
D:\dev\nodejs\node_global
最终类似:
Path
├── D:\dev\nodejs
├── D:\dev\nodejs\node_global
这样全局安装的命令就可以直接使用。
例如:
npm install -g pnpm
安装后可以直接执行:
pnpm -v
六、验证安装
重新打开命令窗口执行:
node -v
示例:
v22.17.0
查看 npm:
npm -v
示例:
10.9.2
查看安装位置:
where node
输出:
D:\dev\nodejs\node.exe
说明环境变量配置成功。
七、配置国内镜像源(推荐)
由于 npm 官方仓库位于国外,下载速度可能较慢。
推荐配置 npmmirror 镜像:
npm config set registry https://registry.npmmirror.com
查看当前源:
npm config get registry
输出:
https://registry.npmmirror.com
恢复官方源:
npm config set registry https://registry.npmjs.org
八、安装测试
安装一个全局工具测试:
npm install -g pnpm
验证:
pnpm -v
如果成功输出版本号,说明:
- Node.js 正常
- npm 正常
- 环境变量正常
- 全局目录正常
九、常见问题
1. node -v 提示不是内部命令
原因
未配置环境变量
解决
检查 Path 是否包含:
D:\dev\nodejs
修改后重新打开命令窗口。
2. npm install 权限不足
原因
当前用户权限不足。
解决
以管理员身份运行 CMD 或 PowerShell。
3. npm 下载速度慢
解决
切换国内镜像:
npm config set registry https://registry.npmmirror.com
4. 查看 npm 配置文件位置
npm config get userconfig
例如:
C:\Users\Administrator\.npmrc
5. 查看 Node.js 和 npm 安装路径
where node
where npm
十、多版本 Node.js 管理(进阶)
如果需要维护多个 Node.js 版本,可以采用如下目录结构:
D:\dev
├── nodejs18
├── nodejs20
├── nodejs22
通过修改环境变量 Path 指向不同版本即可切换。
企业内网环境和离线部署场景推荐使用这种方式。
十一、总结
本文完成了:
✅ 下载 Node.js 解压版
✅ 配置系统环境变量
✅ 配置 npm 全局安装目录
✅ 配置 npm 缓存目录
✅ 配置国内镜像源
✅ 验证 Node.js 环境
✅ 了解多版本管理方案
推荐目录结构:
D:\dev
└── nodejs
├── node.exe
├── node_global
├── node_cache
└── node_modules
这样配置后,Node.js 环境更加清晰,便于维护、迁移和多版本管理,非常适合开发环境和企业内网部署。
参考命令汇总
# 查看版本
node -v
npm -v
# 查看安装路径
where node
where npm
# 设置全局安装目录
npm config set prefix "D:\dev\nodejs\node_global"
# 设置缓存目录
npm config set cache "D:\dev\nodejs\node_cache"
# 查看配置
npm config list
# 查看当前镜像源
npm config get registry
# 设置国内镜像源
npm config set registry https://registry.npmmirror.com
# 恢复官方源
npm config set registry https://registry.npmjs.org
# 安装测试
npm install -g pnpm
pnpm -v
如果本文对你有所帮助,欢迎点赞、收藏、关注,后续将持续分享 Java、Spring Boot、Vue、数据库及开发环境搭建相关实战教程。
更多推荐

所有评论(0)