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

JavaScript最初被设计为运行在浏览器内部的脚本语言，主要用于处理网页交互与DOM操作。要在个人电脑的终端或本地操作系统中直接运行JavaScript代码，脱离浏览器窗口，最标准且通用的方式就是安装Node.js。本文将详细讲解Node.js的运行原理、官网安装包选择、跨平台安装细节、环境验证以及首个脚本的本地运行流程。

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

日常在浏览器中编写和运行JavaScript时，浏览器本身充当了运行容器。它内置了JavaScript引擎（如Chrome的V8、Firefox的SpiderMonkey），同时提供了window、document等Web API。然而，出于安全隔离考虑，浏览器中的JavaScript受到严格沙箱限制，无法随意读取本地硬盘文件、创建网络监听端口或执行系统命令。

Node.js是一个基于Chrome V8引擎构建的开源、跨平台的JavaScript运行时环境。它提取了V8引擎的解析与执行核心，并结合底层C/C++库（如处理异步I/O的Libuv），为JavaScript注入了访问操作系统底层资源的能力。安装Node.js后，开发者就可以像使用Python或Java一样，在本地终端中通过命令行直接运行.js脚本。

二、从官网下载Node.js：LTS与Current版本如何选择？

访问Node.js官方网站（https://nodejs.org/）时，首页通常会提供两个显眼的绿色下载按钮：一个标有 LTS，另一个标有 Current。理解这两个版本的定位是避免后续环境冲突的关键第一步。

对比维度	LTS 版本（长期支持版，推荐）	Current 版本（当前尝鲜版）
全称定义	Long Term Support（通常带有代号如 Iron, Jod）	Current / Latest Features
生命周期	通常提供30个月的安全补丁与高优先级修复	通常维持约6个月，随后平移或停止维护
第三方库兼容性	几乎所有主流开源npm包都会优先确保兼容	部分依赖C++原生编译的扩展包可能出现构建报错
适用人群与场景	日常开发、学习基础语法、商业生产部署（首选）	想提前体验最新ECMAScript特性或测试新API的资深开发者

三、系统安装操作与关键选项配置

下载好对应平台的安装包后，双击即可进入图形化安装引导。无论在Windows还是macOS下，整体安装流程都非常标准化，但需要留意关键选项。

1. Windows平台安装细节（.msi 文件）

• 许可协议：勾选接受协议，点击“Next”。
• 安装路径：默认通常为 C:\Program Files\nodejs\。除非系统盘空间极度受限，否则建议保持默认路径，以减少路径中带空格或特殊字符引发的潜在路径引用异常。
• 自定义设置（Custom Setup）：这里会列出 Node.js runtime、npm package manager、Online documentation shortcuts 以及 Add to PATH。请务必确认 Add to PATH 处于勾选启用状态（默认勾选）。该选项会自动将Node.js安装目录追加至系统环境变量中，省去手动配置的繁琐。
• 额外构建工具（Tools for Native Modules）：安装过程可能会弹出一个可选页面，询问是否安装 Chocolatey、Python 和 C++ 编译工具链。对于纯JavaScript学习和绝大部分日常开发，不要勾选此项。该选项会占用数GB磁盘空间并下载大量系统级编译套件，若后续确实需要编译特定原生包，可以随时按需补充。
• 完成安装：点击“Install”，等待进度条完成后点击“Finish”。

2. macOS平台安装细节（.pkg 文件）

• 下载 .pkg 文件后双击启动安装向导，按照提示依次点击“继续”。
• 系统会将Node.js可执行文件部署至 /usr/local/bin/node，将npm包管理器部署至 /usr/local/bin/npm。
• 在安装摘要页面，向导会明确提示上述路径已被默认注册到系统的命令搜索路径中，直接点击“关闭”完成。

四、验证本地安装是否成功

安装程序关闭后，并不意味着工作全部结束。我们必须通过终端验证命令行工具是否能够被操作系统正确识别。

请注意：如果在安装前你的电脑已经打开了命令行终端（如 Windows Terminal、CMD、PowerShell 或 macOS 的 Terminal），必须先将其关闭并重新打开。这是因为终端在启动时会读取一次系统环境变量，已有窗口无法实时感知新安装写入的PATH变更。

1. 检查 Node.js 与 npm 版本号

在终端中依次输入以下两条命令并回车：

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

# 检查自带的 npm (Node Package Manager) 版本
npm -v

如果安装正常，终端会直接输出形如以下的数字版本标识（具体版本数字取决于你下载时的LTS版本）：

# 输出示例（非真实固定值）：
v20.18.0
10.8.2

2. 体验交互式环境（Node REPL）

除了运行独立代码文件，Node.js还提供了一个即时交互环境（REPL: Read-Eval-Print Loop）。在终端中只输入 node 并回车，光标前会出现一个大于号 >，此时你便可以直接键入JavaScript代码：

$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> 1 + 2
3
> const greeting = "本地运行 JS 成功";
undefined
> greeting.toUpperCase();
'本地运行 JS 成功'
> .exit

在大于号提示符后输入 .exit 或连续按两次 Ctrl + C，即可退出交互模式并回到系统标准终端。

五、编写并运行第一个本地JavaScript文件

交互式REPL虽然适合临时验证单行表达式，但正式开发中我们需要编写代码文件。以下是完整的实践步骤：

1. 新建工作目录与脚本文件

建议为你的JavaScript测试建立一个专门的空文件夹，例如在桌面或用户目录下创建 js-demo。你可以使用任意文本编辑器（如 VS Code、Sublime Text 或系统自带记事本）在文件夹中新建一个名为 app.js 的纯文本文件。

2. 编写脚本内容

在 app.js 中写入以下代码。这段代码展示了控制台输出以及Node.js提供的原生系统信息能力（读取当前Node版本与操作系统平台）：

// app.js
// 1. 基础控制台打印
console.log("------------------------------------------");
console.log("恭喜！你的本地 JavaScript 环境已成功就绪。");

// 2. 调用 Node.js 内置全局对象 process 获取运行态信息
console.log("当前 Node.js 版本号:", process.version);
console.log("当前运行平台架构:", process.platform, process.arch);
console.log("------------------------------------------");

3. 执行代码并查看输出

打开终端，进入存放该文件的目录（例如通过 cd js-demo），然后输入 node app.js 执行：

node app.js

终端中将直接打印：

------------------------------------------
恭喜！你的本地 JavaScript 环境已成功就绪。
当前 Node.js 版本号: v20.18.0
当前运行平台架构: win32 x64
------------------------------------------

至此，你的计算机已经具备完整的JavaScript本地运行与执行能力。

六、安装与运行常见问题排查

初次安装过程中，部分用户可能会遇到命令行报错或权限拦截。以下按发生频次整理了最典型的三种异常及应对方法：

1. 提示 “'node' 不是内部或外部命令，也不是可运行的程序”

这是 Windows 用户最常遇到的问题。其根本原因只有两个：

• 终端未重启：安装完成前打开的终端无法同步新环境变量。请完全关闭现有终端窗口，重新启动新的 CMD 或 PowerShell 窗口。
• 环境变量未写入：安装时误取消了“Add to PATH”勾选。解决方法：右键“此电脑” > “属性” > “高级系统设置” > “环境变量”，在“系统变量”的 Path 中检查是否存在 C:\Program Files\nodejs\。若不存在，手动新建添加该路径并保存。

2. Windows PowerShell 报错：“无法加载文件...因为在此系统上禁止运行脚本”

当尝试运行某些通过npm安装的全局命令时，PowerShell可能会因默认的安全执行策略（ExecutionPolicy）拦截脚本执行。解决方法是在搜索栏找到 PowerShell，右键选择“以管理员身份运行”，执行以下命令：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认后，即可放行本地自建与带有签名的远程脚本。

3. macOS 提示“无法打开，因为无法验证开发者”或权限拒绝

如果在较新版本的 macOS 上双击 .pkg 安装包出现系统安全弹窗提示阻拦：打开“系统设置” > “隐私与安全性”，下拉找到“安全性”一栏，会看到类似“已阻止使用 node...”，点击旁边的“仍要打开”并输入开机密码即可继续。

七、总结

要在本地运行JavaScript，关键在于搭建一个脱离浏览器沙箱的宿主环境。通过Node.js官网下载经过长期验证的LTS版本，能够以最小的维护成本获取高度稳定的开发环境。安装时确认系统环境变量（PATH）的正确配置，随后通过终端版本命令完成双向验证。掌握了命令行下的脚本执行方式后，无论是编写本地自动化工具、搭建后端Web服务，还是开发前端项目工程流，都具备了稳固的基础。