Node.js保姆级教程（下载+安装+环境配置，包含所有版本，2026最新）

Node.js 安装包下载地址：Node.js 安装包（源自官网，Windows、macOS、Linux 全平台版本都有）

Node.js 是一个 JavaScript 运行环境，把浏览器里跑 JavaScript 的 V8 引擎搬到了电脑上，让 JavaScript 能脱离浏览器直接运行。写网站后端、做命令行工具、跑前端构建脚本，用的都是它。

Node.js 能起一个 Web 服务对外提供接口，能读写文件、连数据库、处理定时任务，也能当前端项目的构建工具跑。配合 npm 这个包管理器，装第三方库一条命令就能搞定，目前 npm 仓库里的包有几百万个。

和同类的运行时相比，Node.js 的长处是生态成熟，npm 上的包基本都先支持它，LTS 版本维护周期长，公司项目敢用。

Node.js 免费开源，个人和商业项目都能用，支持 Windows、macOS、Linux，官方还提供 Docker 镜像。全程手把手带大家把 Node.js 的下载、安装、环境配置和使用操作搞清楚，全程实测，无任何门槛，电脑小白也能轻松看懂。

Node.js版本选择

Node.js 的版本分两条线。Current 是刚发布的新版本，功能最新，稳定性一般。LTS 是长期支持版，公司项目和生产环境都用这条线。

很多人下载 Node.js 对着一堆版本号犯难，下面用表格把从常用到最新版本的 Node.js 都列出来，方便对照选择：

版本	状态	发布时间	特点	建议使用场景
Node.js 26	Current（最新版）	2026年	包含最新特性，功能迭代快	尝鲜、学习新功能
Node.js 24	LTS（最新长期支持）	2025年	性能进一步提升，内置 API 更完善	新项目首选，长期维护
Node.js 22	LTS（长期支持）	2024年	成熟稳定，生态兼容性好	生产环境、老项目维护
Node.js 20	旧 LTS 版本	2023年	经典稳定版，使用人数多	兼容性要求高的存量项目
Node.js 18	已停止维护	2022年	曾经的主流版本，已结束支持	仅存老项目，建议尽快升级

新装一律选 LTS，如果确实需要体验新功能，再考虑 Current 版本，但不要在重要项目里用它。

Node.js下载

Node.js 安装包：Node.js 安装包（源自官网，Windows+macOS+Linux）

安装包	大小	说明
node-v24.22.1-x64.msi	31.8 MB	64 位安装版，最常用
node-v24.22.1-arm64.msi	28.4 MB	ARM64 设备用，比如骁龙笔记本
node-v24.22.1-win-x64.zip	36.0 MB	免安装版，解压就能用
node-v24.22.1-linux-x64.tar.xz	30.5 MB	x86-64 机器，解压后配软链
node-v24.22.1-linux-arm64.tar.xz	29.5 MB	ARM64 服务器用
node-v24.22.1.pkg	89.7 MB	通用安装包，Intel 和 Apple 芯片都能用

Node.js安装（Windows）

1）下载 .msi 安装包后双击启动：


2）接受许可协议，直接勾选 I accept... 后继续：


3）选择安装路径，我建议改到非系统盘，比如 D 盘的 nodejs 文件夹，避免占用 C 盘空间：


4）安装类型选择界面，保持默认的 Next 即可，这里默认会包含 Add to PATH 选项，意思就是自动配置环境变量，千万别取消：


5）进入 Tools for Native Modules 界面，询问是否额外安装 Python 和 Visual Studio Build Tools，这两个是编译原生模块用的。有些 npm 包（比如旧版的 node-sass）需要编译原生代码才能运行。对大多数普通用户来说，平时用的包基本不需要原生编译，直接点 Next 跳过就行，省时间也省磁盘空间；如果你打算做需要编译原生模块的开发，再勾上不迟，不过 Visual Studio Build Tools 体积不小，要有心理准备。


6）点击 Install 开始安装：


7）安装完成后在开始菜单里找到 Node.js command prompt（Node.js 命令行），打开后输入下面的命令验证是否安装成功：

• node -v 查看 Node.js 版本，能输出版本号说明安装成功；
• npm -v 查看 npm 包管理工具版本，npm 会随 Node.js 一起安装，不需要单独装。

Node.js环境变量配置

如果你是用 .zip 压缩包解压安装的，或者安装 .msi 时不小心取消了 Add to PATH 的勾选，那系统就找不到 node 命令，输入 node -v 会提示"不是内部或外部命令"。这种情况就需要手动配置环境变量，步骤如下：

1）右键点击"此电脑"或"计算机"，选择"属性"：


2）然后点击"高级系统设置"：


3）在系统属性窗口中，点击"环境变量"按钮：


4）在系统变量部分，找到并选中"Path"变量，点击"编辑"：


5）点击"新建"，把 Node.js 的安装目录路径粘贴进去。比如安装在 D 盘的 nodejs 文件夹，就填 D:\nodejs：


6）点击"确定"保存所有更改。

7）验证安装是否成功。按组合键 Win+R，输入cmd打开命令提示符（cmd）：


输入 node -v 验证。如果输出版本号，就说明环境变量配置成功了。

Node.js基础使用

安装完成后，Node.js 最常用的操作就是跑 JavaScript 文件。新建一个文本文件，比如 hello.js，在里面写一行代码 console.log("Hello Node.js")：


打开 cmd 命令行，执行 node hello.js（要带上文件所在的完整路径），就能看到输出结果了。


除了跑脚本，更常用的是配合 npm 安装第三方包。执行 npm install 包名 就能把需要的库装到当前项目里，比如 npm install express 会安装最流行的 Web 框架 Express。装完后在代码里用 require 引入即可。npm 会自动生成 package.json 文件来记录项目依赖，方便以后一键恢复环境。

如果想开发 Web 服务，可以用 node -e "代码" 直接执行单行代码，或者用 node --watch 文件名 开启文件监听模式，改代码后自动重启，开发调试非常方便。

Node.js新手常见问题

1）提示“node 不是内部或外部命令”怎么办？PATH 里没有 node 目录，手动将安装路径加进 Path，然后重开命令行，问题就解决了。

2）node -v 有版本，npm -v 报错怎么办？npm 没装全，或者 prefix 配错了。重装一次 Node.js。

3）npm install 特别慢或者超时换镜像源：npm config set registry https://registry.npmmirror.com，之后下载速度会有明显提升。

4）npm 和 Node.js 版本对不上怎么办？不用手动对齐，每个 Node.js 版本自带固定版本的 npm，装完就匹配。

5）生产环境只用 LTS。Current 版本随时可能改行为，公司项目跟 LTS 走。

总结

Node.js 是让 JavaScript 跑在浏览器外面的运行环境，免费开源，Windows、macOS、Linux 都能装，写后端接口、命令行工具、前端构建脚本都离不开。按照文章步骤，你的 Node.js 开发环境就能搭建好，接下来就可以开始写代码了。