Windows 安装解压版 Node.js超详细教程前言在 Windows 环境下安装 Node.js 通常有两种方式安装版.msi解压版.zip对于开发人员来说解压版更加灵活无需管理员权限绿色安装删除目录即可卸载方便维护多个 Node.js 版本适合离线环境部署本文以 Windows 10/11 为例介绍如何安装并配置解压版 Node.js。一、下载 Node.js1. 访问官网Node.js 官方网站https://nodejs.org进入官网后可以看到两个版本版本说明LTSLong 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.exeNode.js运行环境npmNode包管理器npxNode命令执行工具三、配置环境变量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 或 PowerShellnpmconfigsetprefixD:\dev\nodejs\node_globalnpmconfigsetcacheD:\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查看 npmnpm-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# 设置全局安装目录npmconfigsetprefixD:\dev\nodejs\node_global# 设置缓存目录npmconfigsetcacheD:\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、数据库及开发环境搭建相关实战教程。
