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、数据库及开发环境搭建相关实战教程。

更多推荐