跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.js大前端

Node.js 安装与环境变量配置指南

Windows 环境下 Node.js 安装需下载官方安装包并配置环境变量。建议安装路径不含中文或空格,设置 npm 全局目录和缓存路径以优化管理。通过修改系统 Path 变量和 NODE_PATH 确保命令行可用。若遇到权限错误 EPERM,可尝试以管理员身份运行终端或使用 icacls 命令修复文件夹权限。国内用户建议配置镜像源提升下载速度。

战神发布于 2026/3/21更新于 2026/9/1069 浏览
Node.js 安装与环境变量配置指南

Node.js 安装与环境变量配置指南

在 Windows 上开发 Node.js 应用,第一步是搭建好运行环境。下面以 Windows 为例,梳理从下载安装到环境变量配置的完整流程,顺便解决几个常见的坑。

下载安装包

访问 Node.js 官网下载页面,选择适合你系统的版本。

官网下载传送门

如果需要旧版本,可以在页面找到'历史版本'入口。

在这里插入图片描述

点击 Windows 安装包(.msi) 进行下载。

在这里插入图片描述

安装程序

双击下载的 .msi 文件开始安装。

  1. 一路点击 Next。
  2. 到了选择安装位置这一步:建议不要装在 C 盘(选 D/E 盘即可),且目录中不要包含中文、空格以及特殊字符。

在这里插入图片描述

  1. 后续步骤保持默认即可。

在这里插入图片描述

在这里插入图片描述

  1. 点击 Install 开始安装。

在这里插入图片描述

  1. 验证是否安装成功。

点击 Finish 完成安装后,按 Win + R,输入 cmd 回车。输入 node -v 和 npm -v 查看版本号。

在这里插入图片描述

能看到版本号,说明基础安装没问题。

环境配置

虽然安装时会自动配置一部分,但为了规范化管理,建议手动设置 npm 的全局目录和缓存路径。

新建两个文件夹

进入这两个文件夹,复制它们的'文件夹地址'(后面要用)。

在这里插入图片描述

打开你的 Node.js 安装目录,新建两个文件夹:node_cache、node_global。

在这里插入图片描述

设置 npm 的全局目录和缓存

按 Win + X,选择 终端(管理员),分别执行下面两条命令(把路径换成你自己的)。

npm config set prefix "D:\Deleloper\runtimes\NodeJS\node_global"
npm config set cache "D:\Deleloper\runtimes\NodeJS\node_cache"

注意:一定要用'管理员'打开终端,否则可能失败。

这里解释一下:prefix 设置 npm 全局安装包的存放目录,当使用 npm install -g package-name 安装全局包的时候,会默认安装到此目录,从而统一管理 Node.js 相关文件。cache 设置 npm 下载缓存的存放目录,将下载的包先缓存到这里,下次安装同版本时直接使用缓存,从而节省空间,加快安装速度。

检查是否设置成功(复制粘贴执行):

npm config get prefix
npm config get cache

显示的是你自己的文件夹地址,就说明对了。

在这里插入图片描述

配环境变量

  1. 右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。

在这里插入图片描述

  1. 点击'新建',创建系统变量 NODE_PATH。

变量值:node_global 文件夹的路径 + \node_modules。

在这里插入图片描述

  1. 在'用户变量'里编辑 Path。

把默认的 ...AppData\Roaming\npm 改成你的 node_global 路径。

在这里插入图片描述

在这里插入图片描述

  1. 在'系统变量'里选择 Path -> '编辑' -> '新建' -> 输入:%NODE_PATH%。

一路点'确定'保存,关闭所有窗口后,重新打开 终端/命令行(这一步很关键)。

在这里插入图片描述

测试配置

按 Win + X,选择 终端(管理员),执行下面命令(安装一个全局包做验证):

npm install express -g

看到安装成功的输出,就说明配置成功。

在这里插入图片描述

设置 npm 国内镜像

如果你发现 npm install 很慢,再做这一步:

  1. 按 Win + X,选择 终端(管理员),执行:
npm config set registry https://registry.npmmirror.com
  1. 验证:
npm config get registry

显示 https://registry.npmmirror.com 就成功。

常见问题

后续会基于新的问题不断添加。

权限不足 (EPERM)

在使用的时候报错较多,显示 EPERM 错误,这个错误通常是因为文件/文件夹权限问题导致的,错误示例如下:

在这里插入图片描述

解决方案: 键盘【Win+X】,打开终端管理员,重新尝试。如果不行,需要修改 Node.js 安装目录权限,修改 npm 缓存目录权限,仍旧在终端管理员执行下述命令。

# 修改 Node.js 安装目录权限
icacls "你的 Node.js 安装目录" /grant Users:F /T
# 修改 npm 缓存目录权限
icacls "你的 node_global 目录" /grant Users:F /T
icacls "你的 node_cache 目录" /grant Users:F /T

可以通过以下指令,获取你对应的目录:

npm config get prefix
npm config get cache

示例如下:

icacls "D:\Deleloper\runtimes\NodeJS" /grant Users:F /T
icacls "D:\Deleloper\runtimes\NodeJS\node_global" /grant Users:F /T
icacls "D:\Deleloper\runtimes\NodeJS\node_cache" /grant Users:F /T

在这里插入图片描述

目录

  1. Node.js 安装与环境变量配置指南
  2. 下载安装包
  3. 安装程序
  4. 环境配置
  5. 新建两个文件夹
  6. 设置 npm 的全局目录和缓存
  7. 配环境变量
  8. 测试配置
  9. 设置 npm 国内镜像
  10. 常见问题
  11. 权限不足 (EPERM)
  12. 修改 Node.js 安装目录权限
  13. 修改 npm 缓存目录权限

更多推荐文章

查看全部
  • 基于 DeepFace 和 OpenCV 的情绪分析器实现
  • Prism 工具简介、安装使用及案例应用详解
  • PPT 嵌入 VR 全景图与空间照片实操指南
  • Java 内存溢出(OOM)排查实战:从复现到 MAT Dump 分析
  • 前端地图开发基础:服务类型、坐标系与 SDK 简介
  • ThinkPHP 和 Laravel 框架的基于 Web 的在线考试答题游戏设计与实现
  • 前端函数防抖详解:原理、手写与 Lodash 实战
  • DeepSeek-R1 大模型基于 MS-Swift 框架部署推理微调指南
  • Python 数据分析通用全流程指南
  • Llama.cpp 跨平台部署本地大模型实战指南
  • Go2 机器人强化学习(RL)开发实操指南
  • C语言标准库与工具链:string.h、stdio.h、stdlib.h及CMake构建
  • Fooocus 部署实践:本地手动配置与云端一键启用对比
  • 如何成为卓越的 AIGC 产品经理:从传统产品到 AI 领域的转型指南
  • Python 基础语法详解
  • FMC 与 FMC+ 标准详解
  • ComfyUI 整合包安装与使用指南
  • Python 基础语法详解:变量、类型、运算符与输入输出
  • 大模型应用开发:RAG 入门与实战
  • 31 岁转行软件测试:一位 34 岁从业者的经历与感悟

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online