Node.js官方下载地址：在本地运行JavaScript环境

一、Node.js 官方唯一正规下载地址与渠道确认

Node.js 是开源项目，由 OpenJS Foundation 维护。获取安装包时务必认准官方顶级域名，避免使用第三方应用下载站或经过非官方打包的捆绑安装包，以防止潜在的供应链安全隐患或不兼容修改。

如果需要获取特定历史归档版本、二进制免安装压缩包（.zip / .tar.xz）或对应的 SHA-256 校验和清单，可直接访问官方发布镜像归档目录：

二、理解本地 JavaScript 环境与浏览器沙箱的区别

在没有安装 Node.js 之前，JavaScript 通常只能作为网页内嵌脚本在 Google Chrome、Firefox 或 Safari 等浏览器的标签页内执行。浏览器为了保护用户本机免受恶意网页侵害，设置了严格的安全沙箱机制。

Node.js 将 Google 浏览器的开源 V8 引擎（由 C++ 编写的高性能 JavaScript 执行引擎）抽取出来，并整合了跨平台异步 I/O 核心库 libuv，让 JavaScript 得以直接运行在本地操作系统层面。

如上图所示，当 JavaScript 迁移至本地 Node.js 环境后，读者获得了直接操作底层宿主系统的全新接口：

• 移除了浏览器特定对象：本地环境不再包含 window、document、HTMLElement 等 DOM/BOM 概念，尝试调用会抛出 ReferenceError。
• 引入了系统级原生核心模块：提供了用于文件读写的 fs 模块、网络通信与服务器构建的 http/net 模块、操作路径的 path 模块，以及查看机器硬件与进程信息的 process 和 os 模块。

三、下载版本选型：LTS 长期稳定版与 Current 最新版

进入官方下载页面后，页面通常会列出两个主要版本的下载按钮：LTS（Long Term Support） 和 Current（最新发布版）。读者应当依据自身项目或学习诉求进行判断。

四、各主流操作系统本地安装与关键步骤

1. Windows 系统安装说明

在官网下载 Windows Installer (.msi) 64-bit 安装包。双击打开安装引导程序：

• 在许可协议界面勾选同意协议（I accept the terms in the License Agreement）。
• 安装目录保持默认即可（默认为 C:\Program Files odejs\）。若修改磁盘路径，路径中尽量不要包含中文或空格。
• 在 Custom Setup（自定义安装选项）页面，确保 Add to PATH（添加到环境变量）处于启用状态。安装程序默认会勾选该项，它会自动将可执行文件目录写入系统的环境变量，无需手动复制路径。
• 在 Tools for Native Modules 页面，询问是否安装 Chocolatey 及 C/C++ 编译工具链。通常情况下不勾选，避免额外下载数个 G 的 Visual Studio 编译套件；后续若遇到确实需要编译原生 C++ 模块的特殊依赖时，再按需单独配置。
• 点击 Install 等待进度条走完，最后点击 Finish 即可。

2. macOS 系统安装说明

官方为 macOS 提供了预签名的 macOS Installer (.pkg)。

• 下载后双击运行 .pkg 文件，按照系统指引持续点击“继续”。
• 安装器会自动将 Node.js 核心二进制文件部署在系统的标准目录：/usr/local/bin/node 与 /usr/local/bin/npm。
• 在 Apple Silicon 芯片（M1/M2/M3/M4 系列）机型上，官方下载页面默认会分发适配 ARM64 架构的通用版本，具备原生执行效率。

3. Linux 系统安装说明

Linux 环境可以直接在官网下载编译好的二进制压缩包（.tar.xz）解压并软链接到 /usr/local/bin，或者使用由 Node.js 官方支持维护的 NodeSource 软件源（以 Ubuntu / Debian 为例）：

# 更新系统源并安装必要依赖
$ sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg

# 导入 NodeSource 官方长期支持源并执行安装
$ curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
$ sudo apt-get install -y nodejs

五、验证本地环境与常见问题排查

安装完成后，必须验证 Node.js 解释器及 npm（Node Package Manager）是否已正确挂载到系统的执行路径中。

1. 启动终端并执行版本检测命令

重要提醒：必须关闭安装前已打开的终端窗口并重新打开一个新的终端（Windows 打开“命令提示符 CMD”或“PowerShell”，macOS 打开“终端 Terminal”），操作系统只会在新开进程时加载更新后的 PATH 环境变量。

# 1. 检查 Node.js 解释器版本
$ node -v
v20.18.0  # 此处应输出类似版本号，表明环境已就绪

# 2. 检查随附的 npm 包管理器版本
$ npm -v
10.8.2    # 此处应输出 npm 对应的版本号

2. 常见问题：提示“不是内部或外部命令”或“command not found”

如果在终端中输入 node -v 后提示找不到命令，原因通常有两个：

• 终端窗口未重新开启：在安装程序运行前打开的终端无法识别新注册的环境变量，关闭所有终端并重新启动即可。
• PATH 环境变量未正确写入：

  Windows 用户可按 Win + R 快捷键输入 sysdm.cpl，点击“高级”选项卡下的“环境变量”，在系统变量中找到名为 Path 的变量并双击，检查其中是否存在 C:\Program Files odejs\。若不存在，点击“新建”将其补全并点击确认保存。

  macOS / Linux 用户若使用 zsh，可检查 ~/.zshrc 文件中是否包含了系统二进制路径导出：export PATH="/usr/local/bin:$PATH"，修改后在终端执行 source ~/.zshrc 即可使之生效。

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

当环境成功校验后，读者即可脱离浏览器，在本地计算机上运行 JavaScript。主要有两种操作途径：交互式解释器（REPL） 与 本地脚本文件运行。

方式一：REPL 交互式命令行运行（快速求值与语法实验）

REPL 代表 Read-Eval-Print Loop（读取-求值-输出-循环）。适合用来快速验证某段语法、计算公式或查看对象结构。

在终端中直接输入 node 并回车，终端光标将变为大于号提示符 >，表示已进入 REPL 交互环境：

$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> const total = [10, 20, 30].reduce((acc, curr) => acc + curr, 0);
undefined
> total
60
> process.platform
'darwin'  // 或 'win32'，直接输出当前宿主系统类型
> .exit  # 或者连续按下两次 Ctrl + C 即可退出 REPL 模式

方式二：编写并运行本地 JavaScript 脚本文件（项目常规开发模式）

实际开发中，逻辑均保存在磁盘文件中。以下通过一个具体示例展示如何在本地创建并运行一个具有系统交互能力的 JavaScript 脚本。

在任意磁盘目录（例如读者工作目录中的 app.js）新建一个文本文件，并输入以下代码：

// 引入 Node.js 原生提供的操作系统与文件系统模块
const os = require('os');
const fs = require('fs');

console.log("=== Node.js 本地运行环境检测 ===");

// 1. 获取宿主计算机基础信息
const systemInfo = {
  platform: os.platform(),
  arch: os.arch(),
  cpuCount: os.cpus().length,
  freeMemMB: Math.round(os.freemem() / (1024 * 1024))
};

console.log(`操作系统平台: ${systemInfo.platform} (${systemInfo.arch})`);
console.log(`CPU 核心总数: ${systemInfo.cpuCount} 核心`);
console.log(`剩余可用内存: ${systemInfo.freeMemMB} MB`);

// 2. 将检测结果写入本地文件
const logContent = `执行时间: ${new Date().toISOString()}
平台: ${systemInfo.platform}
`;
fs.writeFileSync('runtime_status.log', logContent, 'utf-8');

console.log("状态信息已持久化输出至当前目录下的 runtime_status.log 文件。");

保存文件后，在当前文件所在目录下打开终端，执行以下命令：

$ node app.js
=== Node.js 本地运行环境检测 ===
操作系统平台: win32 (x64)
CPU 核心总数: 8 核心
剩余可用内存: 4128 MB
状态信息已持久化输出至当前目录下的 runtime_status.log 文件。

在上述代码运行完毕后，查看当前目录，会发现系统已生成了一个名为 runtime_status.log 的实际文本文件。这直观证明了本地 JavaScript 已经拥有读写硬盘、调用系统模块的能力，完整达成了在本地脱离浏览器运行 JavaScript 的目标。

七、总结与后续指引

要在本地稳定运行 JavaScript，核心路径可以概括为：

1. 唯一定位官方源：通过官方顶级门户 https://nodejs.org/ 或下载聚合页 https://nodejs.org/zh-cn/download 获取原厂安装程序。
2. 坚持选择 LTS：优先安装长期支持版本，确保与广泛的 npm 社区包保持最高兼容度。
3. 验证 PATH 全局注册：安装后在重新启动的终端运行 node -v 与 npm -v，确认执行路径无误。
4. 从本地脚本起步：利用 node <文件名.js> 指令直接调度 V8 引擎与 libuv 执行业务逻辑。

环境配置完毕后，读者便可以继续利用随附的 npm 安装各类现代前端构建工具（如 Vite、Webpack）或后端服务端框架（如 Express、Koa、NestJS），在本地开展完整的 JavaScript 全栈工程开发。