怎么在本地运行JavaScript？Node.js官网下载与安装指南

作者：终端旅客

时间：2026-10-30

本文详细解答如何脱离浏览器在电脑本地直接运行JavaScript，提供Node.js官网LTS版本下载、安装向导环境变量PATH配置、终端版本校验及两种核心运行方式的完整操作指南。

文章目录

假设你刚写好一段用于处理数据或计算结果的 JavaScript 代码，想要立即在电脑上查看运行结果。在很多初学者的直觉中，可能需要先新建一个 HTML 页面，把脚本塞进 <script> 标签里，再双击打开浏览器，最后按下 F12 打开控制台才能看到输出。这种方式不仅繁琐，而且因为浏览器沙箱机制的限制，代码无法直接读取本地磁盘的文件，也无法直接执行系统级命令。要在本地电脑上像运行 Python 脚本或 C 语言程序一样直接运行 JavaScript，核心方案就是安装官方的 JavaScript 运行环境——Node.js。安装完成后，只需在终端中输入一行命令，就能直接执行 .js 文件。

图1：浏览器与 Node.js 运行环境的核心架构与系统调用能力对比

一、Node.js 官网下载：版本类型与选择依据

要获取官方正版的安装包，必须通过官方站点下载。Node.js 官方网站地址为：https://nodejs.org/。在浏览器中打开官网首页时，系统通常会自动检测当前访问者的操作系统（如 Windows 64-bit、macOS Apple Silicon/Intel 或 Linux），并在首页醒目位置显示两个下载按钮：LTS 版本 与 Current 版本。

这两个版本针对的使用群体和生命周期管理完全不同，下载前必须先了解其定位区别：

LTS（Long Term Support，长期维护版）： 官方承诺提供为期 30 个月的安全更新与稳定维护。该版本的 API 已经固化，不会随意发生破坏兼容性的重大变更，是绝大多数企业开发、商业项目以及初学者学习时的标准选择。
Current（当前最新版）： 包含了 Node.js 开发团队最近合入的新特性、前沿语法支持和试验性 API。由于更新频繁，部分底层行为在后续小版本中可能调整，通常仅供需要体验最新语言特性的开发者做技术预研使用。

图2：Node.js 官方 LTS 版本与 Current 版本的核心定位与选择建议

二、系统安装过程与关键设置项

下载好对应系统的安装程序后，双击运行即可启动图形化安装向导。不同操作系统的具体细节如下：

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

在 Windows 环境下，安装包为 .msi 文件。安装步骤通常只需依次点击“Next”，但其中有两处设置需要格外注意：

Custom Setup（自定义安装组件）页面： 这一步会列出 Node.js runtime、npm package manager、Online documentation shortcuts 以及 Add to PATH。请务必确认 Add to PATH 处于勾选状态（默认已选中）。这一项的作用是将 Node.js 的安装路径（通常是 C:\Program Files\nodejs\）自动写入 Windows 的系统环境变量，保证后续在任何目录下打开命令行都能直接调用 node 命令。
Tools for Native Modules（原生编译模块工具）页面： 安装向导后期会弹出一个可选页面，提示是否自动安装 Chocolatey、Python 和 Visual Studio 构建工具。对于刚开始接触本地 JavaScript 运行的读者，建议保持未勾选（留空）直接点击 Next。因为该选项会自动从外网下载数个 G 的编译套件，耗时极长且在基础学习阶段并不需要。

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

macOS 用户会下载到一个 .pkg 文件。双击打开后，按照向导提示输入当前系统的开机密码授予权限。向导会自动将 node 和 npm 可执行文件放置到系统的标准二进制目录下（Intel 芯片 Mac 通常放置在 /usr/local/bin，Apple Silicon M 系列芯片通常放置在 /usr/local/bin 或由包管理器映射在 PATH 中），无需手动配置路径。

图3：Node.js 安装向导、PATH 自动注入与验证全流程步骤图

三、验证安装结果：确认运行环境就绪

向导提示安装完成（Installation Complete）后，需要打开系统命令行工具进行校验：

Windows 用户： 按下键盘快捷键 Win + R，在运行框输入 cmd 或 powershell 并回车；也可以在开始菜单搜索“终端”或“命令提示符”。
macOS 用户： 按下快捷键 Command + 空格 调出聚焦搜索（Spotlight），输入 Terminal 或“终端”并回车。

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

node -v
npm -v

指令与运行输出说明（以下为示例输出，版本号根据安装时间可能有所变化）：

# 检查 Node.js 运行环境版本
$ node -v
v20.18.0

# 检查自带的 npm (Node Package Manager) 包管理器版本
$ npm -v
10.8.2

验证成功的标志： 如果命令行能够正确打印出以字母 v 开头的版本号（例如 v20.18.0），说明 Node.js 已成功安装在你的电脑中，且系统已成功建立了 PATH 命令关联。

常见报错排查： 如果终端提示 'node' 不是内部或外部命令，也不是可运行的程序 或 command not found: node，原因通常是：

安装时未勾选 Add to PATH；
安装完成后未重启终端窗口（旧窗口缓存了旧的环境变量表）；
手动修改了默认安装路径后未同步更新系统变量。

解决方法是完全关闭当前的终端程序，重新打开一个新的终端窗口；若仍未解决，可重新运行安装包并选择“Repair（修复）”确认 PATH 勾选项。

四、在本地运行 JavaScript 的两种核心方式

确认安装成功后，就可以正式在本地执行 JavaScript 了。Node.js 提供了两种最常用的运行场景：交互式 REPL 模式 与 脚本文件执行模式。

方式一：REPL 交互式环境（单行快速测试）

REPL 代表 Read-Eval-Print Loop（读取-求值-输出-循环）。它不需要创建任何代码文件，适合临时验证一段语法、测试内置函数行为或当作高级计算器使用。

操作步骤：

在终端中直接输入 node 并敲击回车，终端提示符会变成大于号 >，表示已进入 REPL 交互环境。
直接输入 JavaScript 语句，按下回车即可立即获得求值反馈。
想要退出交互环境时，输入 .exit 并回车，或者连续按下两次键盘上的 Ctrl + C。

# 进入交互模式
$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.

> 100 + 250 * 2
600

> const message = "Hello, Local JavaScript!";
undefined

> message.toUpperCase()
'HELLO, LOCAL JAVASCRIPT!'

> [1, 2, 3].map(x => x * 10)
[ 10, 20, 30 ]

> .exit

方式二：编写与执行独立的 .js 脚本文件（推荐正式开发方式）

在实际编写功能、工具或网页应用时，代码需要保存在文本文件中以便长期维护。通过 Node.js 执行本地文件的操作非常直接：

第一步：创建脚本文件

在任意你熟悉的文件夹中（例如电脑桌面或项目文件夹），新建一个名为 app.js 的纯文本文件。你可以使用 VS Code、Sublime Text 或系统自带的记事本打开该文件，写入以下示例代码：

// app.js
// 本地 JavaScript 脚本示例
function generateUserReport(username, role) {
  const timestamp = new Date().toLocaleString();
  return {
    user: username,
    role: role,
    createdAt: timestamp,
    status: "Active"
  };
}

const user = generateUserReport("Developer", "Administrator");
console.log("=== 本地 JavaScript 执行结果 ===");
console.log("当前用户信息:", user);
console.log("运行平台系统:", process.platform, process.arch);

第二步：在终端中进入文件所在目录并执行

打开终端，使用 cd 命令切换到存放 app.js 的文件夹目录（也可以在 VS Code 内部直接按下 Ctrl + ` 打开内置终端，内置终端会自动定位在当前项目根目录下）：

# 假设文件存放在当前用户桌面的 js-demo 文件夹
$ cd Desktop/js-demo

# 使用 node 命令后接文件名执行
$ node app.js

终端中会直接打印出脚本的执行输出：

=== 本地 JavaScript 执行结果 ===
当前用户信息: {
  user: 'Developer',
  role: 'Administrator',
  createdAt: '2026/10/25 00:15:20',
  status: 'Active'
}
运行平台系统: darwin arm64

图4：本地运行 JavaScript 两种模式的输入方式、生命周期与适用场景

五、本地运行 JavaScript 的注意事项与排错指南

在本地执行代码的过程中，初学者经常会遇到以下几类典型问题，了解排查原理能快速恢复正常开发：

1. 报错 `Error: Cannot find module 'xxx.js'`

这是本地运行代码时出现频率最高的问题。当在终端输入 node app.js 报出“找不到模块”错误时，并不意味着代码有错，而是终端当前所在的路径并不是存放该文件的文件夹。

排查与解决方法：

在终端输入 dir（Windows）或 ls（macOS/Linux），查看当前列出的文件列表中是否存在目标 app.js。
如果不存在，说明当前终端仍在默认的用户主目录（如 C:\Users\Username），请使用 cd 你的文件夹路径 切换进入对应目录；或者输入 node 空格后，直接从文件管理器中将 app.js 拖入终端窗口，终端会自动补全该文件的绝对路径。

2. Windows 终端提示“禁止运行脚本”（ExecutionPolicy 问题）

当后续学习使用 npm 安装了全局命令行工具，在 Windows PowerShell 中执行时若提示 因为在此系统上禁止运行脚本...，这是 Windows 系统的安全保护机制在起作用。

只需以管理员身份运行 PowerShell，并执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

在弹出的确认提示中输入 Y 确认，即可允许在当前用户下运行本地创建的脚本。

3. 注意本地环境与浏览器环境的 API 差异

在本地 Node.js 环境中执行代码时，请勿调用浏览器专属的对象。例如在脚本中写 window.alert(...) 或 document.getElementById(...) 会直接抛出 ReferenceError: window is not defined 异常。类似地，在浏览器中无法直接使用 process.env 或 require('fs')。清楚两者的能力边界是编写高质量跨端 JavaScript 的基础。

六、总结

在本地运行 JavaScript 的核心逻辑非常清晰：通过 Node.js 官方网站（https://nodejs.org/）下载受长期支持的 LTS 版本，在安装向导中确保 Add to PATH 环境变量被正确写入，最后在终端中通过 node -v 确认环境就绪。无论是在 REPL 交互环境中单行验证语法，还是使用 node 文件名.js 执行完整的脚本逻辑，脱离浏览器沙箱后的 JavaScript 都能直接调用系统的文件与网络资源，成为处理本地自动化任务和工程化开发的高效利器。