【保姆级】Node.js 最新安装教程，附环境变量配置

超级苦力怕
0 阅读3分钟

零基础安装 Node.js（Windows）

  • 你只要照做：下载 -> 安装 -> 配环境变量 -> 验证
  • 看不懂没关系：每张图就是上一步文字的结果

1. 下载安装包

  1. 打开官网下载页：官网下载传送门
  2. 选择你的系统版本，点击 Windows 安装包（.msi） 下载 在这里插入图片描述
  3. 想下载旧版本：在页面里找到“之前的版本/历史版本”入口 在这里插入图片描述

2. 安装程序

  1. 双击下载好的 .msi，一路点 Next
  2. 到选择安装位置这一步：建议不要装在 C 盘（选 D/E 盘即可）、建议目录中不要包含中文、空格以及特殊字符

在这里插入图片描述 3. 这一步保持默认即可 在这里插入图片描述

  1. 继续 Next 在这里插入图片描述

  2. 点击 Install 开始安装 在这里插入图片描述

  3. 点击 Finish 完成安装 在这里插入图片描述

  4. 验证是否安装成功

  • 按 Win + R，输入 cmd 回车
  • 输入：node -v 回车，再输入：npm -v 回车

在这里插入图片描述 能看到版本号，说明安装成功。

3. 环境配置（照做即可）

3.1 新建两个文件夹

  1. 打开你的 Node.js 安装目录，新建两个文件夹：node_cache、node_global 在这里插入图片描述
  2. 进入这两个文件夹，复制它们的“文件夹地址”（后面要用） 在这里插入图片描述

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"

注意：一定要用“管理员”打开终端，否则可能失败。

拓充：

  1. prefix设置 npm 全局安装包 的存放目录，当使用npm install -g package-name安装全局包的时候，会默认安装到此目录,从而统一管理Node.js相关文件。
  2. cache设置 npm 下载缓存 的存放目录，将下载的包先缓存到这里，下次安装同版本时直接使用缓存，从而节省空间，加快安装速度。
  1. 检查是否设置成功（复制粘贴执行）：
npm config get prefix
npm config get cache

显示的是你自己的文件夹地址，就说明对了。 在这里插入图片描述

3.3 配环境变量

  1. 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量” *
  2. 点击“新建”，创建系统变量 NODE_PATH
  • 变量值：node_global文件夹 的路径 + \node_modules 在这里插入图片描述
  1. 在“用户变量”里编辑 Path
  • 把默认的 ...AppData\Roaming\npm 改成你的 node_global 路径 在这里插入图片描述 在这里插入图片描述

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

  2. 一路点“确定”保存，关闭所有窗口后，重新打开 终端/命令行（这一步很关键） 在这里插入图片描述

4. 测试（配置有没有生效）

  1. 按 Win + X -> 选择 终端（管理员）
  2. 执行下面命令（安装一个全局包做验证）
npm install express -g    // -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缓存目录
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

到这里，安装结束

avatar
文章
阅读
粉丝