本地运行JavaScript代码该下载什么？Node.js安装与版本选择指南

在电脑本地运行 JavaScript 代码，最核心需要下载并安装的软件是 Node.js。许多初学者最初接触 JavaScript 时都是在浏览器控制台或 HTML 页面中执行脚本，一旦脱离浏览器窗口，操作系统本身并不自带直接解释执行 .js 文件的引擎。Node.js 将 Google Chrome 浏览器底层高效的 V8 引擎提取出来，并封装了系统文件读写、网络通信等底层接口，使得 JavaScript 能够像 Python 或 C++ 一样作为通用编程语言在本地命令行中直接运行。

一、为什么必须下载 Node.js：运行环境的根本转变

JavaScript 本身只是一套语言规范（ECMAScript）。它要在计算机上运行，必须依赖底层的“运行时环境”（Runtime Environment）。

在网页中运行时，浏览器充当了宿主环境。浏览器提供了 window 全局对象、document DOM 树以及各种网页交互 API，但出于安全沙箱机制的限制，网页中的 JavaScript 无法随意读取你本地硬盘上的文件，也无法直接创建系统后台进程。

而在本地操作系统中，Node.js 充当了全新的宿主环境。它去除了与浏览器紧密相关的 DOM 和 BOM 接口，补充了 fs（文件系统访问）、path（路径解析）、http（网络服务搭建）和 os（系统信息读取）等核心模块。因此，下载并安装 Node.js 是让本地终端识别并执行 JavaScript 代码的标准方案。

图1：浏览器与本地 Node.js 运行环境的底层能力与场景对比

二、版本选择：LTS 长期支持版 vs Current 当前最新版

进入 Node.js 官方网站（nodejs.org）的下载页面时，最显眼的位置通常会展示两个下载按钮：左边通常标记为 LTS（Long Term Support），右边标记为 Current（最新尝鲜版）。许多新手在此处容易产生选择困难，以下是两者的核心技术差异与选型依据：

图2：Node.js 官方版本选择依据与决策路径

三、下载与安装的标准操作步骤

安装 Node.js 非常直观，官方针对各主流系统提供了图形化安装包。整个流程可以归纳为四步：获取安装文件、安装向导配置、终端版本校验、编写运行首个脚本。

步骤 1：从官方渠道获取安装程序

使用浏览器直接访问 Node.js 官方网站 https://nodejs.org。网站会自动识别你的操作系统并推送对应的安装程序：

• Windows 用户：通常下载 .msi 格式的 Windows Installer（64-bit）。
• macOS 用户：通常下载 .pkg 格式的 macOS Installer。对于搭载 Apple 芯片（M1/M2/M3/M4 系列）或 Intel 芯片的 Mac，目前的通用安装包均已良好支持。
• Linux 用户：可以通过系统的官方包管理器（如 apt、dnf、pacman）安装，或者直接使用预编译压缩包解压配置。

步骤 2：运行安装向导（核心关键点）

双击下载的文件启动安装向导，一路点击“Next”（下一步）即可。在 Windows 安装过程中，请务必关注以下选项：

• “Add to PATH” 勾选项：请确保保持默认的勾选状态（将其添加到系统环境变量 PATH 中）。如果漏选了此项，系统在命令行中将无法通过输入 node 找到对应的执行程序。
• “Tools for Native Modules” 提示：向导中途可能会询问是否自动安装 Python、Visual Studio 构建工具等以编译原生 C++ 模块。对于纯粹运行普通 JavaScript 脚本的读者，无需勾选此项，以免额外下载数个 G 的构建工具耗费磁盘空间。

图3：Node.js 安装、配置与初次运行的完整步骤示意

四、验证安装结果与运行第一行代码

安装完成后，计算机不会自动弹出提示框。我们需要通过操作系统自带的终端工具来验证安装是否成功。

1. 启动终端并验证命令

在 Windows 下按下 Win + R 键，输入 cmd 或 powershell 并回车；在 macOS 下按下 Command + 空格，搜索“终端”（Terminal）并打开。

在终端窗口中分别输入以下两条指令：

node -v
npm -v

终端返回内容示例如下（具体数字取决于你下载的实际版本）：

v20.12.2
10.5.0

如果分别输出了类似于 v20.x.x 的版本号以及 npm（Node.js 自带的包管理器）的版本号，说明 Node.js 已成功在你的电脑上就绪。

2. 编写并运行一个独立的 JavaScript 文件

现在你可以开始编写本地脚本。在任意目录下新建一个名为 app.js 的文本文件，在其中写入如下代码：

// app.js
const message = "你好，本地 JavaScript 正在 Node.js 环境中顺利运行！";
console.log(message);

// 读取系统基础信息示例
const os = require('os');
console.log(`当前操作系统平台: ${os.platform()}`);
console.log(`当前系统架构: ${os.arch()}`);

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

node app.js

终端的输出结果示例：

你好，本地 JavaScript 正在 Node.js 环境中顺利运行！
当前操作系统平台: win32
当前系统架构: x64

3. 进入交互式解释器（REPL 模式）

除了运行文件，Node.js 还提供了像 Python 一样的即时交互环境。直接在终端中输入 node 并回车，终端会出现 > 提示符。此时你可以直接输入任意单行 JavaScript 语句并立即得到结果，例如输入 1 + 1 或 Math.random()。想要退出时，连按两次 Ctrl + C 即可。

五、新手初次配置的四大高频问题与排查方法

根据实际安装反馈，初学者在初次安装与运行阶段通常会遇到几个典型报错。以下整理了具体原因与明确的解决办法：

图4：Node.js 安装后高频问题排查与进阶环境建议

1. 刚安装完运行 `node -v` 提示“不是内部或外部命令”

这是最常见的问题。原因往往是你在安装 Node.js 之前就已经打开了命令行窗口。终端的系统环境变量只在窗口启动的那一刻加载，安装程序刚刚添加的路径无法被旧窗口察觉。解决办法非常简单：彻底关闭当前的命令行或终端窗口，重新打开一个新的窗口即可。

如果重启终端后依然提示相同错误，说明安装时未成功写入 PATH。可在“系统属性 -> 高级 -> 环境变量”中找到 Path，检查是否存在 C:\Program Files\nodejs\（Windows 默认路径），如无则手动新建并添加。

2. PowerShell 下执行 npm 全局工具提示禁止运行脚本

在 Windows 下使用 npm 全局安装某些命令行工具后，在 PowerShell 中执行命令可能会弹出红色错误文字：“无法加载文件 ... 因为在此系统上禁止运行脚本”。

这是 Windows 针对 PowerShell 默认启用的安全策略（Restricted）。解决方法：在开始菜单搜索“PowerShell”，右键选择“以管理员身份运行”，然后输入以下命令：

Set-ExecutionPolicy RemoteSigned

在弹出的确认提示中输入 Y 并按回车即可解除该限制。

六、总结与下一步建议

要在本地顺利运行 JavaScript，下载 Node.js 官方 LTS 版本是最稳健、标准的起点。安装后自带的 node 运行时负责解析并执行代码，附带的 npm 工具则为你打开了拥有数百万开源工具包的生态大门。

当确认 node -v 能够正常响应后，你便可以搭配一款优秀的代码编辑器（如 Visual Studio Code），直接在编辑器内置的终端中编写并调试你的 JavaScript 脚本，迈出脱离浏览器、掌控本地系统编程的关键一步。