Node.js下载及安装教程：Windows/Mac本地运行JavaScript环境搭建

Node.js 是一个基于 Chrome V8 引擎构建的开源 JavaScript 运行时（Runtime）。它突破了浏览器沙箱的限制，让 JavaScript 能够作为一门通用编程语言直接运行在本地操作系统上，直接调用操作系统的文件读写、网络监听和底层系统进程能力。无论是从事前端现代工程化（如 Vue、React、Vite 等构建工具）、开发服务端接口，还是编写本地自动化批处理脚本，在计算机中正确安装 Node.js 都是第一步。本文将详细说明 Windows 与 macOS 双平台的官方包选型、标准安装流程、环境验证、执行第一个本地 JavaScript 脚本以及常见环境故障的排查方法。

一、版本选型：LTS 长期支持版与 Current 尝鲜版

打开 Node.js 官方下载页面时，通常会看到两类版本：LTS（Long Term Support，长期支持版）与 Current（当前尝鲜版）。对于绝大多数开发者而言，选择哪一个版本直接决定了本地开发环境的稳定程度：

• LTS 长期支持版（强烈推荐）：以偶数版本号命名（例如 v18、v20、v22）。官方承诺提供长达 30 个月的维护与安全补丁，不会轻易引入破坏性 API 变动。社区中数以万计的第三方 npm 依赖包都会优先适配 LTS 版本。无论是实际业务开发还是新手入门，都应当优先下载 LTS 版本。
• Current 当前尝鲜版：以奇数版本号或最新主版本命名。该版本每两周左右发布一次迭代，包含了最新的 ECMAScript 语法支持和实验性 API，但维护周期仅有约 6 个月。部分需要底层 C++ 编译的 npm 库在 Current 版下可能会出现安装失败或兼容性警告。

二、Windows 平台安装详细步骤

Windows 系统的标准安装包为 .msi（Microsoft Installer）文件。以下为标准安装向导操作步骤：

1. 下载安装包：在官方下载页点击 Windows Installer（.msi），针对现代计算机请选择 64-bit 版本。下载完成后得到形如 node-v20.x.x-x64.msi 的安装程序。
2. 启动安装向导：双击运行该 .msi 文件。在弹出的欢迎界面中点击 Next，勾选“I accept the terms in the License Agreement”接受软件许可协议后继续点击 Next。
3. 选择安装目标目录（Destination Folder）：系统默认路径通常为 C:\Program Files\nodejs\。若磁盘空间充足，建议保持默认路径不变，避免因自定义路径中包含中文、空格或特殊字符引发后续脚本执行异常。
4. 自定义安装功能（Custom Setup）：这一步非常关键。向导展示包含四个默认组件：
   • Node.js runtime：核心运行环境。
   • corepack：用于管理 Yarn 和 pnpm 的工具链。
   • npm package manager：Node 自带的包管理工具。
   • Add to PATH：自动将 Node.js 和 npm 的二进制目录添加到系统环境变量 PATH 中。
   重要提示

   务必保持 Add to PATH 处于启用状态（默认图标为整块硬盘）。只有启用了该项，Windows 系统在打开命令提示符（CMD）或 PowerShell 时，才能在任意工作目录下直接识别 node 和 npm 命令。
5. Tools for Native Modules（可选编译工具）：向导可能会提示是否安装 Python 及 Visual Studio Build Tools 来自动编译原生 C/C++ 模块。对于普通前端开发与日常 JS 脚本编写，无需勾选该复选框（若勾选，安装完成后会通过 PowerShell 自动下载数 GB 的构建套件，耗时较长）。直接点击 Next 即可。
6. 执行并完成安装：点击 Install，在系统 UAC 权限提示中选择“是”授予写入权限。进度条执行完毕后，点击 Finish 退出向导。

三、macOS 平台安装详细步骤

macOS 系统推荐使用官方提供的 .pkg 安装包。根据 Mac 电脑搭载的芯片硬件类型，需注意区分处理器架构：

1. 选择架构下载：
   • 搭载 Apple Silicon 芯片（M1 / M2 / M3 / M4 等）：请下载 macOS Installer (ARM64) 包，可充分发挥芯片的原生指令集性能。
   • 搭载 Intel 处理器的老款 Mac：请下载 macOS Installer (x64) 包。
   • 如果不确定自己的机型，可点击屏幕左上角苹果图标 ->“关于本机”，在“芯片”或“处理器”一栏查看。
2. 运行安装包向导：双击打开下载得到的 node-v20.x.x.pkg。在引言与许可界面连续点击“继续”。
3. 确认安装路径与授权：安装器默认会将 Node.js 二进制程序与 npm 安装到系统公共目录：

   Node.js 执行路径: /usr/local/bin/node
   npm 执行路径:     /usr/local/bin/npm

   点击“安装”，在弹出的 Touch ID 或系统管理员密码认证窗口输入开机密码，等待向导将文件写入系统目录。
4. 安装完成清理：看到“安装成功”提示后点击“关闭”，在弹窗中选择将安装器移入废纸篓以释放磁盘空间。

四、环境验证与编写执行第一个 JavaScript 脚本

完成向导安装后，需要打开系统终端工具进行可用性核验。Windows 用户可按 Win + R 键输入 cmd 或打开 PowerShell；macOS 用户可按 Command + 空格 输入 Terminal 打开终端。

4.1 版本查询验证

在终端窗口中依次输入以下两条命令：

node -v
npm -v

正常情况下，终端将打印当前安装的软件版本号。例如：

v20.18.0
10.8.2

如果两个命令都能正确输出类似上述的版本号，说明 Node.js 与 npm 已经成功写入操作系统环境变量，可以正式投入使用。

4.2 REPL 交互式环境测试

Node.js 提供了一个即时交互环境（REPL，Read-Eval-Print Loop）。直接在终端输入 node 并回车：

$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> const greeting = "Hello, JavaScript on Local Machine!";
undefined
> console.log(greeting.toUpperCase());
HELLO, JAVASCRIPT ON LOCAL MACHINE!
undefined
>

在 REPL 中可以随时测试一段 JS 表达式或标准库方法。连按两次 Ctrl + C 即可退出 REPL 模式返回普通终端命令行。

4.3 创建并运行独立的本地脚本文件

在日常开发中，代码通常保存在独立的 .js 文件中。通过以下步骤体验本地 JavaScript 的系统调用能力：

1. 在本地磁盘创建一个空目录，并在该目录下新建名为 app.js 的文件：

// app.js
// 引入 Node.js 内置的核心模块（无需通过 npm 安装）
const os = require('os');
const path = require('path');

console.log('====================================');
console.log(' Node.js 本地开发环境已成功运行！');
console.log('====================================');

// 1. 获取并输出本地硬件与操作系统信息
console.log(`当前操作系统平台 : ${os.platform()} (${os.arch()})`);
console.log(`系统空闲内存     : ${(os.freemem() / 1024 / 1024).toFixed(2)} MB`);
console.log(`用户主目录路径   : ${os.homedir()}`);
console.log(`当前脚本绝对路径 : ${path.resolve(__filename)}`);

// 2. 演示本地异步非阻塞能力
console.log('\n[任务 1] 同步代码执行完成，正在等待异步定时器...');
setTimeout(() => {
  console.log('[任务 2] 异步定时器触发：本地事件循环（Event Loop）正常运作！');
}, 1000);

2. 在终端中切换到该文件所在目录，使用 node 命令执行该脚本：

node app.js

终端的预期输出如下：

====================================
 Node.js 本地开发环境已成功运行！
====================================
当前操作系统平台 : darwin (arm64)
系统空闲内存     : 3840.50 MB
用户主目录路径   : /Users/username
当前脚本绝对路径 : /Users/username/demo/app.js

[任务 1] 同步代码执行完成，正在等待异步定时器...
[任务 2] 异步定时器触发：本地事件循环（Event Loop）正常运作！

从上述输出中可以看出，JavaScript 在脱离浏览器后，不仅能计算表达式，还可以直接读取本地计算机的 CPU 架构、系统内存与文件系统物理路径。这正是底层架构为 JavaScript 注入的系统级支持能力。

五、npm 基础配置与国内镜像源加速

npm（Node Package Manager）是 Node.js 随包附带的官方包管理器。在本地开发中，几乎所有外部库（如 express、lodash、axios 等）都需要通过 npm 下载安装。由于 npm 官方中央仓库服务器位于海外，国内网络直接下载依赖包时偶有超时或缓慢现象，可通过设置国内镜像源来加速依赖下载：

1. 查看当前源地址：

   npm config get registry

   默认返回官方地址：https://registry.npmjs.org/。
2. 切换为镜像源（例如淘宝 npm 镜像）：

   npm config set registry https://registry.npmmirror.com

3. 验证配置生效： 再次执行 npm config get registry，输出已变为 https://registry.npmmirror.com 即表示配置成功。如后续需切回官方源，只需执行：

   npm config set registry https://registry.npmjs.org/

六、常见环境故障排查与解决方法

在实际安装与初次使用过程中，因系统版本、权限或历史环境残留，读者可能会遇到以下几类常见报错：

1. Windows 终端提示：'node' 不是内部或外部命令，也不是可运行的程序

原因分析：这通常意味着当前命令行窗口打开时未检测到 Node.js 的安装目录，或者在安装向导中遗漏了“Add to PATH”选项。

解决步骤：

• 第一步：如果安装前就已经打开了 CMD 或 PowerShell，请先将所有终端窗口完全关闭，然后重新打开一个新终端测试（环境变量需在新开进程中生效）。
• 第二步：若新窗口仍提示相同错误，请手动检查系统环境变量。按 Win + S 搜索“查看高级系统设置”，点击底部的“环境变量”。在“系统变量”列表中找到 Path 变量并双击编辑。检查是否存在 C:\Program Files\nodejs\（或你的实际安装目录），若不存在，点击“新建”将其添加进去，点击“确定”保存后重启终端。

2. macOS 终端提示：command not found: node

原因分析：macOS Catalina 及更高版本默认使用 zsh 作为终端 Shell。如果安装器写入的 /usr/local/bin 未被正确包含在 zsh 的搜索路径中，就会出现找不到命令的问题。

解决步骤：

• 在终端中运行以下命令，将标准路径显式写入 zsh 配置文件中：

  echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc

• 对于 Apple Silicon 芯片使用 Homebrew 安装的情况，其路径通常位于 /opt/homebrew/bin，对应写入命令为：

  echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc

3. Windows PowerShell 报错：因为在此系统上禁止运行脚本 (PSSecurityException)

原因分析：Windows 默认的 PowerShell 脚本执行策略为 Restricted，当运行部分由 npm 全局生成的 .ps1 脚本（如 npx 或全局 CLI 工具）时，会被系统策略拦截。

解决步骤：在开始菜单右键点击“Windows PowerShell”，选择“以管理员身份运行”，在控制台中执行以下命令：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

根据提示输入 Y 确认修改。该策略允许运行本地编写的脚本以及受信任签名脚本，兼顾安全性与开发便利性。

4. macOS 全局安装 npm 包报权限错误：EACCES: permission denied

原因分析：执行 npm install -g <package> 时，系统试图将文件写入 /usr/local/lib/node_modules，该系统目录默认需要 root 管理员权限。

解决建议：不建议盲目使用 sudo npm install -g（可能导致依赖权限混乱）。推荐修改 npm 的全局安装默认路径到用户个人家目录下：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

七、总结与开发环境进阶建议

完成上述步骤后，你的计算机上已经具备了完整的 JavaScript 本地运行能力。回顾本次环境搭建的核心要点：

• 版本选择：在官方下载页始终优先选择偶数主版本号的 LTS 长期支持版。
• 系统集成：Windows 系统务必保证 Add to PATH 生效；macOS 系统确认 /usr/local/bin（或 ARM 芯片对应的 /opt/homebrew/bin）处于终端 Shell 的搜索路径中。
• 验证步骤：通过 node -v 与 npm -v 双重核验，并借助简单的 app.js 确认本地文件执行与事件循环无误。

在后续更复杂的团队项目协作中，如果面临不同老旧项目需要依赖不同 Node.js 版本的情况，还可以进一步了解多版本管理工具（如 nvm 或 fnm）。它们能让你在同一台电脑上无需重新安装即可秒级切换不同版本的 Node.js 运行时，进一步提升本地开发效率与灵活性。