【2025 年最新】 Node.js 环境安装与配置超详细教程（附图解 + 避坑指南）
Node.js 作为前端开发的核心工具，无论是 Vue、React 等框架开发，还是前端工程化构建，都离不开它。本文将以 2025 年最新版本为例，详细讲解 Node.js 的下载、安装、环境配置全过程，并附带高清图解和常见问题解决方案，确保新手也能一次搞定。
一、Node.js 简介
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，让 JavaScript 可以运行在服务器端。它包含Node 核心程序和npm（包管理工具），安装 Node.js 时会自动附带 npm，无需单独安装。
2025 年的 Node.js 已更新至 v24.x 版本，相比旧版本在性能、安全性和兼容性上有显著提升，推荐安装LTS（长期支持版），适合生产环境使用。
二、下载 Node.js 安装包
1. 访问官方下载地址
打开浏览器，进入 Node.js 官网：https://nodejs.org/
官网首页会自动识别你的操作系统（Windows/macOS/Linux），并推荐合适的版本（LTS 版为首选）。
2. 选择对应版本下载
- Windows 系统：根据系统位数选择（64 位系统选
node-v24.x.x-x64.msi，32 位选x86，目前主流电脑均为 64 位）。 - macOS 系统：推荐下载
.pkg安装包（图形化安装更简单），M1/M2 芯片选择arm64版本，Intel 芯片选择x64。 - Linux 系统：可通过源码编译或包管理器（如
apt/yum）安装，新手建议用.tar.xz压缩包手动配置。
下载图解（以 Windows 为例）：
三、Windows 系统安装步骤
安装步骤
（1）找到下载的.msi文件（如node-v22.3.0-x64.msi），双击运行，会出现如下界面：
(2)直接点【Next】按钮，此处可根据个人需求修改安装路径，修改完毕后继续点击【Next】按钮
（3）可根据自身需求进行，此处我选择默认安装，继续点击【Next】按钮
（4）不选中，直接点击【Next】按钮
（5）点击【Install】按钮进行安装
（6）安装完毕，点击【Finish】按钮
五、验证 Node.js 安装是否成功
1. 打开命令行工具
- Windows：按下
Win+R，输入cmd回车，打开「命令提示符」；或用Win+X选择「Windows PowerShell」。 - macOS/Linux：打开「终端」（Terminal）。
2. 执行验证命令
分别输入以下两条命令，若显示版本号则安装成功：
node -v # 查看Node.js版本 npm -v # 查看npm版本 成功示例：
六、环境变量配置（可选，推荐新手操作）
若安装时未勾选「Add to PATH」，或后续使用中出现node不是内部或外部命令错误，需手动配置环境变量。
Windows 系统手动配置步骤：
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
- 在「系统变量」中找到
Path，点击「编辑」→「新建」，输入 Node.js 安装路径（如D:\Program Files\nodejs）。 - 连续点击「确定」保存配置，重启命令行工具后生效。
七、npm 镜像源配置（解决下载慢问题）
npm 默认镜像源在国外，下载依赖包可能很慢，建议切换为国内镜像（如淘宝镜像）。
1. 查看当前镜像源
npm config get registry 默认显示：https://registry.npmjs.org/
2. 切换为淘宝镜像
npm config set registry https://registry.npmmirror.com/ （淘宝镜像 2024 年已更名为 npmmirror，旧地址registry.npm.taobao.org已停用）
3. 验证镜像源是否切换成功
npm config get registry 显示https://registry.npmmirror.com/即成功。
八、常见问题与解决方案
- 安装后命令行提示 “node 不是内部或外部命令”
- 原因：环境变量未配置或配置错误。
- 解决：重新检查环境变量
Path是否包含 Node.js 安装路径，重启命令行工具。
- npm 下载包时卡住或报错
- 原因：网络问题或镜像源错误。
- Windows 安装时提示 “权限不足”
- 解决：右键安装包，选择「以管理员身份运行」。
- 卸载旧版本 Node.js
- Windows：控制面板→程序和功能→卸载 Node.js；
- macOS：终端执行
sudo rm -rf /usr/local/bin/node /usr/local/bin/npm（谨慎操作）。
解决：切换为国内镜像（见步骤七），或使用cnpm（npm 的国内镜像客户端）：
npm install -g cnpm --registry=https://registry.npmmirror.com/ 九、总结
通过以上步骤，你已成功安装并配置了 Node.js 环境。后续开发中，可通过npm install 包名安装所需依赖，用node 文件名.js运行 JavaScript 文件。
