怎么在本地运行JavaScript：Node.js官网下载安装教程

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

早期设计中，JavaScript 仅被作为浏览器宿主中的脚本语言运行，依赖浏览器提供的解析引擎（如 Chrome 的 V8）和专属 Web API（如 document、window 等网页对象）。这种运行模式受到严格的浏览器安全沙箱限制，脚本无法直接读取本地磁盘文件，也无法自由监听本地端口或与操作系统底层交互。

Node.js 将 Google 开源的 V8 引擎从浏览器中剥离出来，封装在 C++ 编写的底层库（包含负责跨平台异步 I/O 的 libuv）中，提供了一套面向本地操作系统的核心模块。这意味着在 Node.js 环境下，JavaScript 不仅保留了全部标准语法，还拥有了直接操作本地文件系统（fs 模块）、处理网络套接字（http/net 模块）以及访问系统环境变量（process 对象）的原生能力。

二、官网下载：认准渠道与选择正确版本

获取 Node.js 安装包的唯一可信途径是官方网站：nodejs.org。请避免从第三方软件下载站获取安装程序，以免被捆绑非必要的广告软件或下载到被篡改的旧版本。

进入官网首页后，系统通常会自动识别你的操作系统，并直接呈现两个不同版本的下载按钮：LTS（长期支持版）与Current（当前尝鲜版）。

三、系统安装详细步骤与核心选项

下载得到安装包后，Windows 用户会获得 .msi 安装文件，macOS 用户会获得 .pkg 安装包。双击运行安装向导，按照以下四个主要步骤推进：

1. 许可协议与安装路径

打开安装向导后，点击“Next”接受许可协议。随后会进入安装路径选择界面：

• Windows：默认为 C:\Program Files\nodejs\。除非系统盘空间极度受限，否则建议保持默认路径，以避免权限继承和特殊中文字符路径引发的异常。
• macOS：安装器会自动将 Node 可执行文件写入 /usr/local/bin/node 或 /opt/homebrew/bin/node（由芯片架构决定），并自动配置软链接。

2. 定制组件与关键的 PATH 环境变量

在 Windows 安装界面的“Custom Setup”步骤中，会列出 Node.js runtime、npm package manager 以及 Add to PATH 三个核心项。

至关重要的检查点：请确认 Add to PATH 处于启用状态（默认图标为安装到本地驱动器）。这一步的作用是将 Node.js 的安装目录追加到操作系统的全局环境变量 Path 中。如果去掉了这个选项，你在任意目录下打开命令行输入 node，系统都会提示“无法找到该命令”。

3. 可选工具链页面（Tools for Native Modules）

在点击最终安装之前，向导会弹出一个提示是否安装“Tools for Native Modules（Chocolatey、Python、Visual Studio 编译工具）”的复选框。

明确建议：初学者请不要勾选此项。该选项专门用于编译带有 C/C++ 底层扩展的特殊 npm 包，勾选后会在后台静默下载超过 3GB 的大型工具包，极其消耗磁盘空间与网络带宽，而常规的 JavaScript 运行与普通前端项目完全不需要这些工具。直接点击“Next”跳过即可。

四、验证安装结果与运行第一个 JavaScript 脚本

安装完成后，必须验证系统是否已经正确识别了 Node.js 与随之自带的 npm（Node Package Manager）工具。

1. 打开终端并验证版本

重要提示：如果你的终端（如 Windows 的 CMD、PowerShell，或 macOS 的 Terminal）在安装前就已经处于打开状态，请将其完全关闭并重新打开。因为新注册的环境变量只有在创建新终端会话时才会被读取。

在终端窗口中输入以下两行命令并分别按下回车：

# 检查 Node.js 运行时版本
node -v

# 检查 npm 包管理器版本
npm -v

如果配置正确，终端会直接输出类似于以下格式的版本号（示例）：

[终端输出示例]
v20.18.0
10.8.2

能够正常显示 v 开头的版本号，说明 Node.js 已经完全部署就绪。

2. 运行 JavaScript 的方式一：REPL 交互式命令行

在终端中只输入 node 并回车，就会进入 Node.js 提供的 REPL（Read-Eval-Print Loop，读取-求值-输出循环）交互式环境。你可以像在浏览器控制台（DevTools Console）里一样，即时编写并执行单行代码：

# 在终端直接启动交互模式
node

[交互输出示例]
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> 100 + 250
350
> const greeting = "你好，本地 JavaScript！";
undefined
> console.log(greeting.toUpperCase());
你好，本地 JAVASCRIPT！
undefined
> .exit

在 > 提示符后，连续按下两次 Ctrl + C，或者输入 .exit 并回车，即可退出交互式环境返回普通命令行。

3. 运行 JavaScript 的方式二：编写并运行 .js 脚本文件（推荐）

真正的项目开发中，代码都是保存在磁盘文件中的。下面按照标准步骤创建并执行一个完整的本地脚本：

第一步：创建工作文件夹与脚本文件。在电脑的任意位置（例如桌面或开发目录）新建一个名为 my-js-test 的文件夹，进入该文件夹，使用任何文本编辑器（如 VS Code、记事本等）创建一个名为 index.js 的文件。

第二步：编写 JavaScript 代码。在 index.js 中写入以下内容并保存：

// index.js: 本地 JavaScript 脚本示例
const os = require('os');

function showSystemInfo() {
  const platform = os.platform();
  const arch = os.arch();
  const freeMemMB = (os.freemem() / 1024 / 1024).toFixed(0);

  console.log('====================================');
  console.log('恭喜！你的第一个本地 JavaScript 脚本运行成功！');
  console.log(`当前操作系统: ${platform} (${arch})`);
  console.log(`系统空闲内存: ${freeMemMB} MB`);
  console.log('====================================');
}

showSystemInfo();

第三步：在命令行中定位目录并执行。打开终端，使用 cd 命令进入 index.js 所在的文件目录，执行 node index.js：

# 切换到脚本文件所在文件夹 (以桌面上的路径为例)
cd Desktop/my-js-test

# 使用 node 解释器执行脚本文件
node index.js

此时终端会立即打印出执行结果：

[终端输出示例]
====================================
恭喜！你的第一个本地 JavaScript 脚本运行成功！
当前操作系统: win32 (x64)
系统空闲内存: 8320 MB
====================================

这段代码不仅输出了问候信息，还成功调用了 Node.js 内置的 os 模块读取了当前计算机的硬件架构与内存状态，这正是浏览器端 JavaScript 无法做到的本地系统级能力。

五、常见问题排查与解决建议

在初次安装与运行过程中，若遇到无法正常调用的情况，绝大多数是由以下三个原因引起的：

六、总结

在本地运行 JavaScript 的全过程可以归纳为三个关键动作：从官网 nodejs.org 甄选并下载 LTS 长期支持版、在安装向导中确保 Add to PATH 环境变量写入，并在全新打开的终端中通过 node -v 确认环境可用。

成功迈出这一步后，JavaScript 就不再局限于网页特效，你已经具备了探索现代前端工程化（Webpack/Vite）、后端服务端开发（Express/NestJS）以及自动化脚本处理的完整本地基础环境。