Node.js 下载安装与环境配置全流程（保姆级详解）| 图文详解，快速上手

前言

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。它采用事件驱动、非阻塞式 I/O 模型，使得其在处理高并发任务时具有极高的效率。得益于这样的设计，Node.js 在 Web 开发、实时应用、微服务架构等场景中被广泛使用。

除了高性能，Node.js 还配备了功能强大的包管理器 npm（Node Package Manager）。npm 提供了丰富的开源库和工具，开发者可以轻松地安装、管理和共享代码，使开发过程更加高效。

---

一、下载安装 Node.js

1.下载安装包：

• 访问 Node.js 官方下载页面。

通常页面会显示两个版本：

1. 长期维护版本（推荐）：该版本更加稳定，适合企业应用或生产环境。
2. 最新版本：该版本包含最新功能，但可能不够稳定，适合尝试新特性或测试用途。

2.安装程序

1. 下载完成后，双击安装包，开始安装 Node.js，点击 Next。

   

2. 勾选I accept the terms in the License Agreement，然后点击 Next。

   

3. 此处可根据个人需求修改安装路径，修改完毕后继续点击Next按钮。

   

4. 直接点击Next下一步。

   

5. 这一步的选项Automatically install the necessary tools（自动安装所需工具）决定了是否安装用于编译原生模块的依赖项。这包括 Python 和 Visual Studio Build Tools 等工具。

   

   如果勾选：Node.js 会自动安装这些工具，并配置好相关依赖，适合需要使用原生模块（如 bcrypt、node-sass 等）开发或测试的用户。
   如果不勾选：系统不会安装这些工具，但可以手动配置依赖。如果后续不需要编译 C/C++ 模块，则不勾选也不会影响普通 JavaScript 开发。

6. 开始安装，点击Install按钮。

   

7. 安装完毕，点击Finish按钮。

   

3.测试安装

1. 按下 win + r 键，输入cmd，打开cmd窗口。

   

2. 输入以下命令并回车，验证版本信息：

   node -v   // 检查 Node.js 版本  
   npm -v    // 检查 npm 版本
   

   • 如果正确输出版本号（如下图所示），说明安装成功。
   • 如果命令未识别，请检查环境变量配置。

   

---

二、环境配置

1.创建文件夹

• 打开安装目录，新建两个文件夹 node_global 和 node_cache。

2.配置 npm 路径

1. 以管理员身份打开命令提示符（CMD）。

2. 输入以下命令，将路径替换为你创建的文件夹路径：

   npm config set prefix "你的路径\node_global"
   npm config set cache "你的路径\node_cache"
   

   示例（假设路径为 E:\nodejs）：

   npm config set prefix "E:\nodejs\node_global"
   npm config set cache "E:\nodejs\node_cache"
   

3. 完成路径配置后，可以通过以下命令验证是否设置成功：

   npm config get prefix
   npm config get cache
   

   

   注意事项：

   1. 如果输出的路径与配置路径一致，说明路径配置成功。
   2. 确保路径正确：复制刚刚创建的 node_global 和 node_cache 文件夹路径，避免路径输入错误。
   3. 权限问题：如果提示权限不足，请确认已使用管理员身份运行命令提示符。

3.配置环境变量

1. 右键点击桌面上的 此电脑（或“计算机”），选择 属性 ，点击 高级系统设置，然后选择 环境变量。

2. 在 系统变量 区域，点击 新建，输入以下内容，然后点击确定。

   • 变量名：NODE_PATH
   • 变量值：E:\nodejs\node_global\node_modules （复制刚刚创建的node global路径并在后面添加\node modules）

3. 编辑用户变量 Path：

   • 在 用户变量 区域，选择 Path 变量，点击 编辑
     

   • 将默认的 C:\Users\你的用户名\AppData\Roaming\npm 路径修改为 node_global 文件夹的路径（如 E:\nodejs\node_global），然后点击确定。
     

4. 更新系统变量 Path：

   • 在 系统变量 区域，选择 Path，点击 编辑
     
   • 点击 新建，输入 %NODE_PATH%，然后依次点击确定关闭所有窗口。
     

5. 完成环境变量配置后，重新打开 cmd ，输入以下命令验证：

   echo %NODE_PATH%
   

   如果输出正确路径（如 E:\nodejs\node_global\node_modules），说明环境变量已配置成功。

   

---

三、测试

1. 全局安装 express 模块（以管理员身份运行 CMD）：

   npm install express -g
   

   -g 参数表示全局安装，出现类似下图说明安装成功。

   

2. 安装成功后，node_global 文件夹下会生成 node_modules 目录。

   

3. 输入以下命令验证安装路径：

   npm root -g
   

   

   若输出路径为 node_global\node_modules，说明配置成功。

---

四、配置镜像

1.设置淘宝镜像（可选并推荐）

1. 淘宝镜像是淘宝团队为国内用户提供的npm镜像源，它与官方镜像源保持同步，并提供了更快的下载速度。

2. 输入以下命令将 npm 镜像源设置为淘宝镜像：

   npm config set registry https://registry.npmmirror.com
   

3. 验证配置：

   npm config get registry
   

   若返回 https://registry.npmmirror.com，说明镜像源设置成功。

   

2.安装 cnpm（可选）

1. 输入以下命令全局安装 cnpm（淘宝版 npm 工具）：

   npm install -g cnpm --registry=https://registry.npmmirror.com
   

2. 验证安装：

   cnpm -v
   

   

---

结尾

至此，我们已经完成了 Node.js 的下载安装、环境配置以及镜像设置等操作。通过全局安装 express 模块验证了配置的正确性，并通过淘宝镜像优化了 npm 的下载效率。希望本教程能够帮助你顺利搭建 Node.js 开发环境。

本教程参考自 2024 最新版 Node.js 下载安装及环境配置教程【保姆级】 进行编写，感谢原作者提供的详细指导。教程中若遇到报错或问题，可优先参考该博客提供的解决方法。

如果在操作过程中遇到问题，欢迎在评论区留言交流，一起解决问题。祝你开发顺利，开启高效的 Node.js 开发之旅！🚀🎉