Node.js官网中文下载指南：怎么在本地运行JavaScript代码

JavaScript 最初被设计为运行在网页浏览器内部的脚本语言，主要用于操作网页结构、响应用户交互。如果想要脱离浏览器，在个人电脑的本地系统里直接编写、调试并执行 JavaScript 代码，就必须在电脑上安装 Node.js 运行环境。本文将详细介绍如何通过 Node.js 官方网站获取适配操作系统的安装包、完成基础环境搭建与校验，并通过两种标准方式在本地运行第一段 JavaScript 代码。

一、核心原理：浏览器与本地 Node.js 运行环境的区别

在安装软件前，有必要先了解为什么本地运行 JavaScript 需要借助 Node.js。在浏览器环境中，JavaScript 引擎（如 Chrome 的 V8）受到严格的“沙盒机制”保护，出于安全考虑，脚本无法直接读取本地文件、无法监听网络端口，也不能控制系统进程。这种限制保证了普通用户在访问陌生网页时，电脑内的私密文件不会被恶意脚本读取。

Node.js 则是一个基于 Chrome V8 引擎构建的开源、跨平台 JavaScript 运行时环境。它将 V8 引擎从浏览器中提取出来，并结合底层系统调用库（libuv 及 C++ 扩展），为 JavaScript 补充了操作系统层面的功能支持。安装 Node.js 之后，JavaScript 拥有了直接读写本地磁盘文件（fs 模块）、处理系统路径（path 模块）、搭建 Web 后端服务（http 模块）等系统级能力，从而成为一种能够编写本地工具和后端程序的通用编程语言。

二、官网入口与下载版本选择：LTS 与 Current

下载 Node.js 的唯一推荐途径是其官方网站。Node.js 官方针对全球开发者提供了本地化门户，其中文官方网站地址为：

https://nodejs.org/zh-cn

当打开该页面时，网站系统会自动识别读者正在使用的操作系统（如 Windows 64-bit 或 macOS ARM64/Intel），并在首页醒目位置并列展示两个下载选项：LTS（长期支持版）与 Current（最新版）。初学者面对这两个选项往往不清楚该如何挑选，具体差异如下：

• LTS 版本（Long Term Support）：即“长期支持版本”。偶数编号的版本（如 v18、v20、v22 等）在经过一段时间的社区验证后会转为 LTS。该版本的核心设计目标是“稳定可靠”。在整个支持周期（通常为 30 个月）内，官方只对该版本进行关键性安全修复和高危缺陷维护，不会引入具有重大破坏性的破坏性语法变更。
• Current 版本：即“最新尝鲜版本”。该版本包含了 Node.js 团队最新合并的代码、实验性的新 API 以及最新版的 V8 引擎特性。但由于更新频繁，部分第三方依赖包（NPM 包）可能尚未对其完成兼容适配，使用过程中存在遇到不可预期报错的风险。

三、各操作系统安装步骤与注意事项

点击 LTS 下载按钮后，浏览器会获取对应的本地安装向导文件。不同操作系统的具体安装步骤如下：

1. Windows 操作系统（.msi 安装包）

1. 下载完成后，双击获得的 node-vXX.XX.X-x64.msi 文件启动安装向导。
2. 在协议同意页勾选“I accept the terms in the License Agreement”，点击 Next。
3. 安装路径设置：建议保留默认路径（C:\Program Files\nodejs\），如果更改盘符，路径中切勿出现中文字符或特殊符号。
4. 自定义设置（Custom Setup）：此步包含核心组件，请务必确认 “Add to PATH”（添加到系统环境变量）选项处于启用状态（默认已选中）。这是终端能够全局识别 node 命令的关键所在。
5. 原生编译工具安装项（Tools for Native Modules）：向导最后可能会弹出一个名为“Automatically install the necessary tools”的可选勾选框，该项会通过 Chocolatey 自动下载 Python 和 Visual Studio C++ 编译环境。对于仅运行通用 JavaScript 脚本的初学者，无需勾选此项，直接点击 Next 并点击 Install 即可。

2. macOS 操作系统（.pkg 安装包）

1. 根据 Mac 的处理器架构下载对应的安装包：搭载 Apple Silicon 芯片（M1/M2/M3/M4 系列）的机型选择 macOS Installer (ARM64)；搭载 Intel 处理器的老款机型选择 macOS Installer (x64)。如果直接在官网首页点击下载，官网会自动匹配当前系统架构。
2. 双击打开 .pkg 安装包，按照提示连续点击“继续”。
3. 安装程序会自动将 node 和 npm 的软链接放置在系统的 /usr/local/bin 路径下，该路径默认已存在于 macOS 的系统环境变量中，无需手动干预。

四、验证安装结果：检查终端环境变量

安装向导执行结束后，必须通过终端验证 Node.js 及其附带的 npm（Node Package Manager，包管理器）是否成功注册到了系统的环境变量中。

node -v
npm -v

执行后如果输出类似于以下格式的版本号（示例）：

v20.18.0
10.8.2

只要控制台输出了以字母 v 开头的版本号，就表明 Node.js 已经在当前计算机中顺利就绪，可以开始运行 JavaScript 代码。

五、在本地运行 JavaScript 代码的两种实操方式

在本地执行 JavaScript 代码有两种主要场景：临时测试单行语法的“交互式命令行（REPL）”，以及用于开发完整功能的“脚本文件执行”。

方式一：使用 REPL 交互式环境（即时演练）

REPL 代表 Read-Eval-Print Loop（读取-求值-输出-循环）。这是一种无需创建任何代码文件，即可直接在终端里输入 JavaScript 语句并立刻查看执行结果的方式，非常适合用来验证某个内置函数、测试数学计算或调试简短逻辑。

1. 打开终端，直接输入命令 node 并敲击回车，终端提示符会变为大于号 >，表示已进入 REPL 交互环境。
2. 在 > 提示符后输入 JavaScript 代码，例如：

   console.log("你好，本地运行的 JavaScript！");

   按下回车，终端下一行会立刻打印出字符串，随后返回 undefined（因为 console.log 函数本身没有返回值）。
3. 再输入一个数学表达式进行测试：

   const a = 10;
   const b = 25;
   a * b + 100;

   按下回车后，控制台会立刻计算并输出数字 350。
4. 退出 REPL：连续按下两次快捷键 Ctrl + C，或者输入 .exit 并回车，即可退回到系统的普通终端提示符。

方式二：编写 .js 脚本文件并执行（工程标准方式）

日常编写工具、自动化脚本或后端程序时，通常需要将代码保存在独立的文本文件中。以下是标准实操步骤：

mkdir js-demo
cd js-demo

// 引入 Node.js 内置的操作系统信息模块
const os = require("os");

// 编写核心测试逻辑
const appName = "我的第一个本地 JavaScript 脚本";
console.log(`=== ${appName} ===`);

// 获取当前计算机系统信息并输出
const platform = os.platform();
const cpus = os.cpus().length;
console.log(`当前操作系统平台: ${platform}`);
console.log(`当前 CPU 核心数: ${cpus} 核`);

// 执行一个简单的数组操作
const numbers = [1, 2, 3, 4, 5];
const sum = numbers.reduce((total, n) => total + n, 0);
console.log(`1 到 5 累加之和为: ${sum}`);
console.log("执行完毕，Node.js 运行正常！");

node app.js

按下回车后，Node.js 会载入该文件并从头到尾解释执行，终端中将清晰展示如下示例输出：

=== 我的第一个本地 JavaScript 脚本 ===
当前操作系统平台: darwin
当前 CPU 核心数: 8 核
1 到 5 累加之和为: 15
执行完毕，Node.js 运行正常！

六、本地运行常见报错与排查清单

初学者在完成安装及首次运行脚本的过程中，常见问题通常由环境配置或概念混淆引起。以下是对应排查方法：

1. 报错：Cannot find module 'xxx/app.js'

原因：Node.js 无法在当前执行目录下找到名为 app.js 的文件。
解决方法：在终端输入 dir（Windows）或 ls（macOS/Linux），查看当前列出的文件列表中是否存在目标脚本。如果不在，使用 cd 目录名 命令切换到文件所在的正确路径，或者使用绝对路径执行：node "D:\js-demo\app.js"。

2. 报错：ReferenceError: window is not defined 或 document is not defined

原因：尝试在 Node.js 中执行含有网页专用对象（如 window.alert()、document.getElementById()）的前端代码。
解决方法：如前文所述，Node.js 是纯净的本地运行时，不存在浏览器 DOM 页面与浏览器窗口环境。本地运行应专注数据计算、文件处理或接口网络逻辑；如果需要操控网页元素，该段代码应放置在 HTML 的 <script> 标签内由浏览器加载运行。

3. 中文乱码问题

原因：在 Windows 命令提示符（CMD）下，由于默认编码（GBK）与脚本文件的保存编码（UTF-8）不一致，控制台输出中文时可能会出现乱码。
解决方法：确保代码编辑器保存 .js 文件时采用“UTF-8”编码格式；推荐在 Windows 上优先使用 Windows Terminal 或 PowerShell，或者在 CMD 中先执行 chcp 65001 将当前控制台编码切换为 UTF-8。