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:
npmconfigsetprefix"D:\dev\nodejs\node_global"npmconfigsetcache"D:\dev\nodejs\node_cache"查看配置:
npmconfig list或者:
npmconfig get prefixnpmconfig get cache五、配置全局模块环境变量
继续编辑系统变量 Path。
新增:
D:\dev\nodejs\node_global最终类似:
Path ├── D:\dev\nodejs ├── D:\dev\nodejs\node_global这样全局安装的命令就可以直接使用。
例如:
npminstall-gpnpm安装后可以直接执行:
pnpm-v六、验证安装
重新打开命令窗口执行:
node-v示例:
v22.17.0查看 npm:
npm-v示例:
10.9.2查看安装位置:
wherenode输出:
D:\dev\nodejs\node.exe说明环境变量配置成功。
七、配置国内镜像源(推荐)
由于 npm 官方仓库位于国外,下载速度可能较慢。
推荐配置 npmmirror 镜像:
npmconfigsetregistry https://registry.npmmirror.com查看当前源:
npmconfig get registry输出:
https://registry.npmmirror.com恢复官方源:
npmconfigsetregistry https://registry.npmjs.org八、安装测试
安装一个全局工具测试:
npminstall-gpnpm验证:
pnpm-v如果成功输出版本号,说明:
- Node.js 正常
- npm 正常
- 环境变量正常
- 全局目录正常
九、常见问题
1. node -v 提示不是内部命令
原因
未配置环境变量解决
检查 Path 是否包含:
D:\dev\nodejs修改后重新打开命令窗口。
2. npm install 权限不足
原因
当前用户权限不足。
解决
以管理员身份运行 CMD 或 PowerShell。
3. npm 下载速度慢
解决
切换国内镜像:
npmconfigsetregistry https://registry.npmmirror.com4. 查看 npm 配置文件位置
npmconfig get userconfig例如:
C:\Users\Administrator\.npmrc5. 查看 Node.js 和 npm 安装路径
wherenodewherenpm十、多版本 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-vnpm-v# 查看安装路径wherenodewherenpm# 设置全局安装目录npmconfigsetprefix"D:\dev\nodejs\node_global"# 设置缓存目录npmconfigsetcache"D:\dev\nodejs\node_cache"# 查看配置npmconfig list# 查看当前镜像源npmconfig get registry# 设置国内镜像源npmconfigsetregistry https://registry.npmmirror.com# 恢复官方源npmconfigsetregistry https://registry.npmjs.org# 安装测试npminstall-gpnpmpnpm-v如果本文对你有所帮助,欢迎点赞、收藏、关注,后续将持续分享 Java、Spring Boot、Vue、数据库及开发环境搭建相关实战教程。