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

Node.js 最新安装教程及环境变量配置

Node.js 在 Windows 系统上的安装流程包含下载官方安装包、执行安装向导、配置环境变量及 npm 全局路径。通过设置 prefix 和 cache 目录优化包管理,调整 Path 变量确保命令可用。配置国内镜像源提升下载速度,并解决常见的 EPERM 权限错误。验证 node 与 npm 版本确认环境就绪。

DotNetGuy发布于 2026/3/15更新于 2026/7/2333 浏览
Node.js 最新安装教程及环境变量配置

Node.js 最新安装教程及环境变量配置

零基础安装 Node.js(Windows)

1. 下载安装包

  1. 打开官网下载页:官网下载传送门

想下载旧版本:在页面里找到'之前的版本/历史版本'入口

选择你的系统版本,点击 Windows 安装包(.msi) 下载

2. 安装程序

  1. 双击下载好的 .msi,一路点 Next
  2. 到选择安装位置这一步:建议不要装在 C 盘(选 D/E 盘即可)、建议目录中不要包含中文、空格以及特殊字符
  3. 这一步保持默认即可
  4. 继续 Next
  5. 点击 Install 开始安装
  6. 验证是否安装成功

点击 Finish 完成安装

  • 按 Win + R,输入 cmd 回车
  • 输入:node -v 回车,再输入:npm -v 回车

能看到版本号,说明安装成功。

3. 环境配置(照做即可)

3.1 新建两个文件夹

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

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

3.2 设置 npm 的全局目录和缓存
  1. 按 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 下载缓存的存放目录,将下载的包先缓存到这里,下次安装同版本时直接使用缓存,从而节省空间,加快安装速度。

  1. 检查是否设置成功(复制粘贴执行):
npm config get prefix
npm config get cache

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

3.3 配环境变量
  1. 点击'新建',创建系统变量 NODE_PATH

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

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

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

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

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

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

4. 测试(配置有没有生效)

  1. 按 Win + X -> 选择 终端(管理员)
  2. 执行下面命令(安装一个全局包做验证)
npm install express -g

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

5. (推荐) 设置 npm 国内镜像(下载更快)

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

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

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


到这里,你的 Node.js 安装与环境变量配置就完成了。

6. 常见问题

6.1 权限不足 (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. 零基础安装 Node.js(Windows)
  3. 1. 下载安装包
  4. 2. 安装程序
  5. 3. 环境配置(照做即可)
  6. 3.1 新建两个文件夹
  7. 3.2 设置 npm 的全局目录和缓存
  8. 3.3 配环境变量
  9. 4. 测试(配置有没有生效)
  10. 5. (推荐) 设置 npm 国内镜像(下载更快)
  11. 6. 常见问题
  12. 6.1 权限不足 (EPERM)
  13. 修改 Node.js 安装目录权限
  14. 修改 npm 缓存目录权限
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 基于 LLaMA-Factory 和 LoRA 在 AutoDL 上微调 GPT-OSS-20B 模型
  • tksheet完整指南:Python Tkinter表格组件的终极解决方案
  • C++ 开发基础:STL 核心组件与字符编码避坑指南
  • OpenClaw 龙虾机器人部署及进阶配置教程
  • DeepSeek R1 开源模型引发全球复现热潮与技术解析
  • 基于 Windows 服务器部署微信接入 DeepSeek AI 聊天机器人
  • Qoder AI 编辑器深度体验:长期记忆、Wiki 与 Quest 模式解析
  • 两两交换链表中的节点
  • Qwen-Image 与 Midjourney V6 实测:中文理解与细节还原能力对比
  • Visual Studio 2026 GitHub Copilot Agent 模式解析
  • Coze 智能体开发指南:从配置到工作流实战
  • Mac Mini M4 本地 AI 实战:Ollama 与 SD 配置指南
  • Qclaw AI 智能体深度测评:本地执行与跨端能力实战
  • LangChain 实战案例:TextToSQL 应用解析
  • 基于 Dify 的数据分析应用搭建实战
  • Android WebRTC SDK 入门指南:从零搭建实时音视频通信应用
  • Linux 编程中常用的控制线程函数详解
  • 机器人 DH 参数模型与正运动学
  • RocketMQ 5.0 延时消息架构:时间轮算法与分布式调度实践
  • Flutter eth_sig_util 鸿蒙适配指南:以太坊加密签名与 Web3 开发

相关免费在线工具

  • 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