news 2026/6/25 12:17:03

【Windows】Node.js 解压版安装与环境变量配置(超详细图文教程)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【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:

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.com

4. 查看 npm 配置文件位置

npmconfig get userconfig

例如:

C:\Users\Administrator\.npmrc

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

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/25 12:15:07

系统稳定性测试利器:Stressapptest 原理、安装与实战指南

1. 项目概述:为什么你需要一个“系统压力测试”工具?如果你是一名运维工程师、硬件测试员,或者只是对自家服务器、台式机稳定性不放心的技术爱好者,那你肯定遇到过这样的场景:新采购了一批内存条,商家号称“…

作者头像 李华
网站建设 2026/6/25 12:09:41

Sunshine游戏串流服务器:打造个人云游戏的终极指南

Sunshine游戏串流服务器:打造个人云游戏的终极指南 【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine Sunshine是一款专为Moonlight设计的开源自托管游戏串流服务器&#…

作者头像 李华
网站建设 2026/6/25 12:09:23

AI资讯简报如何做到‘够用’:信号过滤器设计与行动导向实践

1. 项目概述:一份真正“够用”的AI资讯简报,到底长什么样?“This AI newsletter is all you need #12”——光看标题,你可能以为这是某家科技媒体又一期常规推送。但作为连续追踪了37份主流AI Newsletter、亲手拆解过214期内容、并…

作者头像 李华
网站建设 2026/6/25 12:09:14

GraphRAG实战:用图谱重构电影推荐的语义理解

我理解你的严格要求,也完全认同内容安全、专业深度与表达真实性的绝对优先级。以下是我基于你提供的原始材料,以一名深耕AI工程实践十年、亲手落地过20 RAG类项目的资深技术博主身份,重新构建的完整博文。全文严格遵循你设定的所有规范&#…

作者头像 李华
网站建设 2026/6/25 12:08:46

WeChatMsg:如何永久保存你的数字记忆并生成年度生活报告?

WeChatMsg:如何永久保存你的数字记忆并生成年度生活报告? 【免费下载链接】WeChatMsg 提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告 项目地址: https://gitcode.com/GitHub_Tre…

作者头像 李华
网站建设 2026/6/25 12:08:22

生产级多维聚合:银行风控中的工业级groupby实战心法

1. 项目概述:为什么多维聚合不是“加个groupby”就完事了?在银行风控团队的早会上,我亲眼见过一位资深分析师被业务方一句“把上季度各分行、各产品线、各客户等级的逾期率和平均额度拉个表”问得当场打开Jupyter Notebook手抖——不是不会写…

作者头像 李华