想在本地运行JavaScript代码？Node.js官方下载安装指南

要在个人电脑的终端或操作系统中脱离浏览器直接执行 JavaScript 代码，最标准、成熟且通用的方案是安装 Node.js 运行时。本文将提供清晰的官方下载指引、版本选择建议、全平台安装步骤、环境验证方法以及运行首个本地 JS 脚本的具体流程。

一、为什么本地运行 JavaScript 需要 Node.js

JavaScript 最初被设计为网页脚本语言，必须依附于浏览器环境（如 Chrome 的 V8 引擎或 Safari 的 JavaScriptCore 引擎）执行。在浏览器中，JavaScript 可以操作页面元素（DOM）、处理浏览器历史记录（BOM）并发送网络请求，但出于系统安全策略限制，网页脚本无法直接读取本地文件、监听系统端口或管理操作系统进程。

Node.js 本质上是一个脱离浏览器的独立运行时环境。它同样基于 Google V8 JavaScript 引擎构建，但用 C++ 封装并提供了文件读写（fs）、网络服务（http/net）、路径处理（path）以及系统底层异步 I/O 支持（通过 libuv 库）。安装 Node.js 后，JavaScript 就能像 Python、Ruby 或 Go 一样，成为能够编写本地批处理脚本、命令行工具以及后台服务程序的通用编程语言。

二、官方下载渠道与版本选型：LTS 还是 Current？

获取 Node.js 时，必须始终通过官方网站渠道：https://nodejs.org。进入官网首页后，系统通常会自动识别你的操作系统，并呈现两个醒目的下载下载按钮：LTS（长期支持版）与 Current（最新发布版）。

选择结论：对于绝大多数想要在本地运行 JavaScript 的读者，请无条件选择 LTS 版本。LTS 具有最高的生态兼容性，能够确保第三方 npm 依赖包平稳安装，避免因底层 API 变动遭遇意外编译故障。

三、主流平台下载与安装详细步骤

1. Windows 操作系统安装

• 下载文件：在官网点击 LTS 下载 .msi 格式的 Windows 安装包（通常为 64-bit）。
• 运行向导：双击运行下载好的 node-vXX.XX.X-x64.msi 文件。
• 许可协议：勾选 "I accept the terms in the License Agreement" 并点击 Next。
• 安装路径：默认路径为 C:\Program Files\nodejs\，直接保持默认即可。
• 特性选择（至关重要）：在 "Custom Setup" 界面，确保 Add to PATH（添加到系统环境变量）处于勾选激活状态。安装程序会自动将 Node 和 npm 的执行路径注册到系统的环境变量中。
• 额外工具（可选）：向导可能会询问是否安装 "Tools for Native Modules"（Python 与 Visual Studio 编译工具）。纯学习或运行普通 JS 代码无需勾选，直接点击 Next 略过即可。
• 完成安装：点击 "Install"，系统提示 UAC 授权确认后点击“是”，等待进度条跑完并点击 "Finish"。

2. macOS 操作系统安装

• 安装包方式（图形化）：在官网下载 .pkg 文件，双击打开。按照提示一直点击“继续”并输入 Mac 账户登录密码授权，安装器会自动将二进制文件放置于 /usr/local/bin（Intel 芯片）或 /opt/homebrew/bin，并配置好终端调用路径。
• 包管理器方式（推荐给熟悉终端的用户）：若已安装 Homebrew，可直接在终端中执行：

  brew install node@20

3. Linux 系统安装

Linux 各发行版官方仓库中预置的 node 版本往往滞后。推荐通过 NodeSource 官方维护的脚本仓库安装对应 LTS 分支：

# Ubuntu / Debian 示例（以 v20 LTS 为例）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

四、验证安装结果与环境变量

安装完成后，计算机并不会生成像浏览器那样的独立图形桌面图标。我们需要打开操作系统的命令行终端进行检查：

• Windows：按键盘快捷键 Win + R，输入 cmd 或 powershell 并回车。
• macOS：按快捷键 Command + 空格，输入 Terminal（终端）并回车。

在打开的黑底或白底终端窗口中，分别输入以下两条指令：

node -v
npm -v

如果配置正常，终端将立即回显对应的版本号数字（例如）：

v20.18.0
10.8.2

五、运行你的第一个本地 JavaScript 脚本

环境验证通过后，即可开始在本地编写并运行实际的 JavaScript 代码。通常有两种执行方式：交互式 REPL 与独立脚本文件运行。

方式一：创建并运行脚本文件（最常用）

第一步，在电脑任意位置（例如桌面或个人工作文件夹）新建一个文本文件，命名为 app.js。

第二步，使用任意代码编辑器（如 VS Code、Sublime Text，甚至系统自带的记事本）打开该文件，写入一段标准的 JavaScript 代码：

// app.js
const author = "开发者";
const message = "JavaScript 已经在本地成功运行！";

function sayHello(name) {
    return `你好，${name}！本地时间：${new Date().toLocaleTimeString()}`;
}

console.log(message);
console.log(sayHello(author));

第三步，打开终端并切换到该文件所在的目录，执行 node 文件名.js：

cd Desktop
node app.js

第四步，观察终端输出。如果看到类似下方的文本，说明代码已在本地执行完毕：

JavaScript 已经在本地成功运行！
你好，开发者！本地时间：20:30:15

方式二：使用 Node.js 交互式 REPL

如果你只想临时测试简短的 JavaScript 表达式或语法，可以在终端直接输入 node 并回车，进入交互式终端（REPL）：

$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> [1, 2, 3].map(x => x * 2)
[ 2, 4, 6 ]
> Math.max(10, 25, 8)
25
> .exit

在 > 提示符后可即时输入任意 JS 代码，按回车即可立即获得求值结果。输入 .exit 或连续按下两次 Ctrl + C 即可退出 REPL 回到系统命令行。

六、新手常见问题与排错方案

在初次安装与使用 Node.js 时，以下是最高频出现的几种异常现象及排查手段：

1. 提示 “'node' 不是内部或外部命令，也不是可运行的程序”

• 原因：终端尚未载入最新的环境变量配置，或者安装时没有勾选 "Add to PATH"。
• 解决方案：
  1. 首先完全关闭当前的终端窗口，重新打开一个新的终端测试。因为环境变量仅对新打开的会话生效。
  2. 如果依然报错，需手动检查 Windows 系统环境变量：右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”，在“系统变量”下的 Path 中确认是否存在 C:\Program Files\nodejs\。若缺失，点击编辑并手动添加该路径。

2. 提示 “Cannot find module '...'” 或找不到指定文件

• 原因：终端当前所在的工作目录与脚本文件实际存放的目录不一致。
• 解决方案：先使用 pwd（macOS/Linux）或 cd（Windows）查看当前命令行所在的文件夹路径。使用 cd 目标路径 跳转到 app.js 存放的目录，或者在执行命令时传入文件的绝对路径，例如 node "C:\Users\YourName\Desktop\app.js"。

3. 在代码中调用 alert() 或 document.getElementById() 报错

• 原因：初学者容易混淆前端浏览器专属 API 与后端运行时 API。document、window、alert 均为浏览器提供的 DOM/BOM 接口，Node.js 并不包含渲染页面引擎，因此这些对象在本地未定义。
• 解决方案：在本地输出信息请统一使用 console.log()。若需要进行文件操作，应使用 Node.js 提供的 const fs = require('fs');。

七、总结

在本地直接运行 JavaScript 代码的核心要点可以概括为三步：

1. 下载选型：认准官方网站 nodejs.org，毫不犹豫选择稳定可靠的 LTS 长期支持版本。
2. 安装验证：保持默认配置并确保勾选 Add to PATH，在终端通过 node -v 与 npm -v 确认环境就绪。
3. 执行代码：新建 .js 文件编写代码，在终端中通过 node 文件名.js 即可直接运行并获得结果。

通过配置好 Node.js，你已经成功为本地计算机装配了现代 JavaScript 的执行引擎，不仅可以执行独立脚本，还可以进一步通过 npm 探索更丰富的工具链与服务端开发世界。