怎么在Windows和Mac上安装Node.js以本地运行JavaScript代码

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

JavaScript 最初是设计运行在 Web 浏览器内部的脚本语言，依赖浏览器的内置引擎解析执行，并由浏览器提供 DOM（页面文档对象模型）与 BOM（浏览器对象模型）等特定接口。如果在没有浏览器的普通操作系统文件夹中双击 .js 文件，操作系统并不知道该由谁来执行代码。

Node.js 的出现改变了这种单一方面。它将 Google 开发的开源 V8 引擎抽离出来，补充了操作系统层面的输入输出（I/O）、文件系统访问（fs 模块）、网络通信（http 模块）及路径处理（path 模块）能力。安装 Node.js 之后，计算机的操作系统层就获得了执行 JavaScript 的解释器，我们可以像使用 Python 或 Shell 脚本一样，通过命令行执行本地 JavaScript 代码。

二、在 Windows 系统上安装 Node.js

在 Windows 环境中，官方推荐采用安装包（MSI 文件）进行一键安装，该方式会自动将程序目录添加到系统环境变量 PATH 中，无需手动修改高级系统设置。

1. 下载长期支持版（LTS）

访问 Node.js 官方网站（nodejs.org）。主页通常会展示两个版本选项：

• LTS（Long Term Support，长期支持版）：稳定性经过充分验证，官方维护周期长，是日常开发与生产环境的首选。
• Current（最新尝鲜版）：包含最新的语言特性与实验性 API，可能存在第三方依赖库未兼容的问题。

建议绝大多数读者点击下载 LTS 版本的 Windows 安装包（如 node-v20.x.x-x64.msi）。

2. 运行安装向导

1. 双击打开下载好的 .msi 文件，点击 Next 进入协议接受页面。
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”（原生编译工具）界面，通常可以不勾选自动安装 Chocolatey 和 Python，除非后续要编译依赖 C/C++ 的底层原生扩展模块。初学者跳过该项可节省数 GB 的磁盘空间与下载时间。
6. 点击 Install，在系统弹出的用户账户控制（UAC）对话框中选择“是”，等待安装条走完后点击 Finish。

三、在 Mac 系统上安装 Node.js

macOS 用户主要有两种安装途径：使用官方 .pkg 图形安装器，或者使用 macOS 常见的包管理工具 Homebrew。两种方式各有优势。

途径一：官方 .pkg 安装包（适合所有用户）

1. 访问官方网站 nodejs.org，系统会自动识别 macOS 并推荐 macOS 安装包（.pkg 文件）。
2. 如果你的 Mac 是 Apple Silicon 芯片（M1/M2/M3/M4 系列），官方会提供 ARM64 架构对应的安装包；如果是 Intel 芯片则提供 x64 架构。
3. 双击打开下载的 .pkg 文件，按照提示点击“继续”。
4. 输入 Mac 的锁屏开机密码或通过触控 ID 授权系统安装。
5. 安装程序会自动将执行二进制文件置于 /usr/local/bin/node 或 /opt/homebrew/bin/node，并同时安装 npm（Node 包管理器）。

途径二：通过 Homebrew 安装（适合习惯终端的开发者）

如果你的电脑中已配置了 Homebrew 包管理器，可以在终端（Terminal）中直接执行以下命令安装 Node.js LTS 版本：

# 更新本地仓库信息
brew update

# 安装 Node.js 当前稳定版本
brew install node

Homebrew 会自动处理软链接并配置当前用户的环境变量，升级时仅需输入 brew upgrade node 即可，管理相对集中。

四、验证安装结果与查看版本

安装完成后，必须打开终端以确认系统能够正确识别 node 以及伴随安装的 npm 程序。

1. 打开系统的终端程序

• Windows：按下键盘上的 Win + R 键，输入 powershell 或 cmd，按回车键打开终端。
• Mac：按下快捷键 Command + 空格 调出聚焦搜索（Spotlight），输入 终端 或 Terminal，按回车打开。

2. 运行版本检查命令

在打开的终端光标后输入以下命令并回车：

node -v

如果安装成功，终端会输出类似如下的版本编号（示例输出）：

v20.18.0

接着验证伴随安装的 npm 包管理器版本：

npm -v

输出示例：

10.8.2

只要两条命令均能正常打印出版本号，就说明 Node.js 已成功挂载到系统环境中。

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

安装好 Node.js 后，本地运行 JavaScript 主要有两种场景：利用 REPL 交互式环境 进行即时代码试验，或者通过命令行运行写好的 .js 脚本文件。

方式一：进入 REPL 交互式运行环境（快速测试语法）

在终端中直接输入 node 并按回车，终端会显示提示符 >，此时已经进入了交互模式。你可以在这里直接输入 JavaScript 表达式并立刻查看求值结果：

$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> 1 + 2
3
> const fruits = ['apple', 'banana'];
undefined
> fruits.map(f => f.toUpperCase())
[ 'APPLE', 'BANANA' ]

测试完成后，连续按下两次 Ctrl + C 键，或者输入 .exit 即可退出交互模式返回系统终端。

方式二：编写并运行独立的 JavaScript 脚本文件（项目核心开发方式）

真实开发中，我们通常将代码保存在独立的文本文件中，然后交由 Node.js 执行。以下是完整的操作步骤：

1. 在你的电脑上新建一个学习目录，例如在桌面创建名为 js-demo 的文件夹。
2. 使用任意代码编辑器（如 Visual Studio Code、Sublime Text，或系统的记事本、文本编辑）在 js-demo 文件夹下新建一个文件，命名为 app.js。
3. 在 app.js 中写入以下示例代码：

   // app.js - 本地运行示例脚本
   const os = require('os');
   
   function displayGreeting(name) {
     const currentHour = new Date().getHours();
     let timePeriod = '白天';
     if (currentHour < 12) timePeriod = '上午';
     else if (currentHour < 18) timePeriod = '下午';
     else timePeriod = '晚上';
   
     return `你好，${name}！当前是${timePeriod}，JavaScript 已在本地成功运行。`;
   }
   
   console.log('----------------------------------------');
   console.log(displayGreeting('开发者'));
   console.log(`运行平台: ${os.platform()} (${os.arch()})`);
   console.log(`Node.js 版本: ${process.version}`);
   console.log('----------------------------------------');

4. 保存文件并确保文件编码为 UTF-8。
5. 在终端中切换到保存该文件的目录，然后通过 node 命令执行它：

   # 切换到脚本所在目录（以桌面项目为例）
   cd ~/Desktop/js-demo    # Mac 系统
   cd Desktop\js-demo      # Windows 系统
   
   # 使用 Node.js 执行该文件
   node app.js

执行后终端将立即打印出控制台信息，输出示例：

----------------------------------------
你好，开发者！当前是晚上，JavaScript 已在本地成功运行。
运行平台: darwin (arm64)
Node.js 版本: v20.18.0
----------------------------------------

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

安装与初次运行过程中，因操作系统权限或配置不同，可能遇到几类常见问题：

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

在 Windows 上出现该提示，说明系统当前的 PATH 环境变量中找不到 node.exe。排查步骤如下：

• 确认是否重启了终端：在安装完成前打开的终端无法感知新注入的环境变量，完全关闭该终端窗口并重新打开即可。
• 手动检查安装路径：进入 C:\Program Files\nodejs\ 查看是否存在 node.exe。若存在，打开“系统属性” -> “环境变量”，在用户变量或系统变量的 Path 中新增一条记录：C:\Program Files\nodejs\，保存后重启终端。

2. macOS 提示“command not found: node”

macOS 默认使用 zsh 作为终端 Shell。如果安装后找不到命令，通常是环境配置文件（~/.zshrc）未包含 Node 的 bin 目录。可以执行：

echo $PATH

检查输出中是否包含 /usr/local/bin（Intel 芯片）或 /opt/homebrew/bin（Apple Silicon 芯片配合 Homebrew）。若缺失，可在 ~/.zshrc 末尾补充路径并执行 source ~/.zshrc。

3. 执行 node 脚本时报错“Cannot find module”

例如执行 node app.js 提示 Error: Cannot find module '.../app.js'，这代表终端当前所在工作目录与脚本文件实际保存路径不一致。请先在终端输入 pwd（Mac）或 cd（Windows）核对当前路径，或者直接使用文件的绝对路径运行：

# 使用绝对路径执行（Windows 示例）
node "C:\Users\username\Desktop\js-demo\app.js"

# 使用绝对路径执行（Mac 示例）
node "/Users/username/Desktop/js-demo/app.js"

七、总结

通过安装 Node.js，本地操作系统具备了执行 JavaScript 语言的核心运行库与模块解析能力。在 Windows 上借助官方 MSI 安装包、在 macOS 上借助 PKG 安装包或 Homebrew 均可轻松完成安装。只要在终端中通过 node -v 确认版本输出正常，便可以随时创建 .js 文件并通过 node 脚本名.js 命令在本地高效执行代码，为后续的前端工程化构建、服务端开发或本地自动化脚本打下坚实基础。