怎么从官方渠道下载Node.js以运行JavaScript代码

作者：岩茶时间：2026-10-30 18:45:04浏览：86

详细讲解如何从官方渠道安全下载、安装Node.js，配置运行环境并执行首个JavaScript脚本，涵盖LTS版本选择、跨平台安装流程、环境变量验证与常见问题排查。

在计算机上脱离浏览器直接执行JavaScript代码，最稳定且标准的方式是安装Node.js运行时环境。获取该环境的唯一可靠入口是Node.js官方网站。本文将明确官方下载渠道的具体地址，解析长期支持版（LTS）与尝鲜版（Current）的区别，逐步演示安装配置过程，并指导你编写并运行第一个本地JavaScript脚本。

一、确认官方渠道与版本选择

在检索软件下载时，搜索引擎常夹杂第三方软件站、非官方打包镜像或推广下载器，这些来源可能附带过时版本甚至捆绑广告。Node.js的唯一官方主域名为 nodejs.org。打开浏览器访问该网站后，首页会根据访问设备的操作系统自动呈现对应的下载按钮。

在官方下载页面上，用户通常会面对两个版本分支：LTS（Long Term Support，长期支持版） 与 Current（当前最新发布版）。理解两者的定位是正确下载的第一步：

LTS版本（强烈推荐）：生命周期通常长达30个月，重点保障API的向后兼容性和生产级稳定性，几乎所有主流技术框架（如Express、Vue CLI、Next.js）均以此版本为基准进行回归测试。对于学习编程、日常开发与企业部署，应当默认选择LTS。
Current版本：包含最新的ECMAScript语法规范实现和Node.js核心试验性API，但更新频繁且可能发生不兼容调整，仅适合评估新功能的研究型场景。

怎么从官方渠道下载Node.js以运行JavaScript代码 — 图1：Node.js官方入口认证与LTS/Current版本选择决策

二、操作步骤：各平台下载与标准安装

Node.js官方针对主流操作系统提供了预编译的图形化安装包与压缩归档，安装流程清晰直观。

1. Windows平台安装步骤

在官网点击 LTS 按钮，下载获取 node-vXX.XX.X-x64.msi 安装包。
双击运行安装向导，在欢迎界面点击“Next”，阅读并接受许可协议。
选择安装目标路径，通常保持默认目录（如 C:\Program Files\nodejs\）即可。
在“Custom Setup”定制组件树中，保持全部默认勾选。其中关键项 Add to PATH 必须保持开启，向导会自动将Node.js和npm的可执行路径写入系统环境变量。
在“Tools for Native Modules”步骤中，除非你需要编译包含C/C++原生扩展的特定底层模块，否则建议不要勾选自动安装Chocolatey及编译工具链，以免额外耗费数GB磁盘空间与漫长的等待时间。
点击“Install”，弹出UAC管理员权限确认时选择“是”，等待安装进度完成即可。

2. macOS平台安装步骤

在官网下载 node-vXX.XX.X.pkg 安装程序（官网会根据Apple芯片或Intel芯片自动分发适配版本）。
双击 .pkg 文件，按照屏幕提示逐步确认安装位置，输入系统登录密码完成授权。
安装器会将二进制文件写入 /usr/local/bin（Intel芯片）或自动配置到系统调用路径中。

三、验证环境：检查Node.js与npm状态

安装向导执行完毕后，首要任务是在终端环境中确认安装是否生效。注意：必须先关闭安装之前就已经打开的命令行窗口，然后重新启动一个新的终端（Windows使用PowerShell或命令提示符CMD，macOS使用终端Terminal），因为旧终端窗口不会主动刷新系统环境变量。

在终端中键入以下命令查询版本：

node -v

如果安装成功，终端将输出安装的具体版本号（示例）：

v20.18.0

随后检查伴随Node.js一同安装的Node包管理器（npm）：

npm -v

终端将返回npm的版本号（示例）：

10.8.2

关键排错：提示“'node' 不是内部或外部命令”怎么办？

如果在Windows执行 node -v 时收到该报错，原因通常有两个：一是未关闭旧终端并打开新终端；二是安装过程中解除了PATH环境变量的勾选。解决方法是进入Windows“系统属性” -> “环境变量”，检查系统变量 Path 中是否存在 C:\Program Files\nodejs\。若不存在，手动添加该路径并保存，重新打开终端即可。

四、编写并运行第一行JavaScript代码

Node.js提供了两种运行JavaScript代码的形式：交互式解释器（REPL） 与 脚本文件执行。

方法一：使用交互式命令行（REPL）

当你只需要临时测试某段简单的JavaScript语法或算术表达式时，可以直接在终端输入 node 并按回车：

node

此时终端提示符将变为 >，表示已进入Node.js交互环境。直接输入以下语句：

console.log("Hello, Node.js!");

按回车后即可在下方立即看到输出结果：

Hello, Node.js!
undefined

注：第二行的 undefined 是该表达式在JavaScript中的返回值，属于正常现象。连续按下两次 Ctrl + C 即可退出REPL环境。

方法二：创建并执行 `.js` 脚本文件（开发标准做法）

在实际工程和学习过程中，代码通常持久化保存在文件中。请按照以下步骤操作：

在任意工作目录（例如桌面或项目文件夹）新建一个文本文件，重命名为 app.js。

使用文本编辑器（如VS Code、Sublime Text或系统记事本）打开该文件，写入如下代码：

// app.js
const message = "从官方渠道下载Node.js成功，JavaScript已在本地正常运行！";
console.log(message);

const numbers = [1, 2, 3, 4, 5];
const total = numbers.reduce((sum, current) => sum + current, 0);
console.log("数字求和结果:", total);

保存文件后，在终端中切换到该文件所在目录，执行以下命令：
```
node app.js
```

终端将按预期打印执行结果：

从官方渠道下载Node.js成功，JavaScript已在本地正常运行！
数字求和结果: 15

五、操作避坑与常见注意事项

常见问题 / 现象	底层发生原因	针对性解决措施
安装后终端提示 command not found	系统环境变量未注入，或者旧终端会话未感知最新PATH注册	彻底关闭当前所有终端窗口重新打开；检查环境变量是否包含Node安装根目录。
全局安装模块提示 EACCES 权限错误 (macOS/Linux)	默认全局目录属于 `/usr/local` 等受保护的管理员路径	避免使用 `sudo npm`；推荐使用 `nvm`（Node版本管理器）管理开发目录权限。
执行中文输出出现乱码 (Windows CMD)	默认CMD活动代码页为GBK（936），无法直接解析UTF-8中文字符	在执行代码前在CMD输入 `chcp 65001` 切换为UTF-8，或改用现代化终端Windows Terminal / PowerShell。
代码中调用了 window 或 document 报错	Node.js是服务端运行环境，不包含浏览器专属的DOM与BOM对象	属于概念混淆。Node.js拥有专属的 `fs`（文件系统）、`http`（网络通信）、`path`（路径处理）等后端API。