Windows/Mac怎么下载Node.js？环境变量配置常见问题解决

在计算机上安装 Node.js 并让开发环境正常运转，本质上只有两项工作：一是从正规渠道获取对应操作系统的程序文件，二是让系统的命令行工具能够在任何路径下定位并执行 node 和 npm 程序。无论是 Windows 还是 macOS，只要理清“安装程序把文件放在哪里”以及“系统是如何在 PATH 中查找命令的”，遇到任何提示“找不到命令”或“不是内部或外部命令”的问题，都能在几分钟内准确定位并排除。

一、Node.js 官方下载与版本选择依据

下载 Node.js 的唯一权威途径是官方网站 nodejs.org。打开首页后，通常会看到两个主要版本分支：

• LTS（长期支持版，Long Term Support）：稳定性优先，推荐所有日常学习、生产项目和商业团队使用。它的 API 保持高度向后兼容，第三方模块适配完善。
• Current（当前最新版）：包含最新的 JavaScript 语法支持与底层引擎特性，主要面向尝鲜者或需要测试新功能的开发者，稳定性略低于 LTS。

对于绝大多数读者，请始终优先下载 LTS 版本。官网会自动根据你的浏览器标识推荐匹配当前操作系统的安装包。

二、Windows 平台下载、安装与自动环境变量配置

在 Windows 下，最稳妥的安装方式是下载后缀为 .msi 的 64 位 Windows Installer 安装包。

双击运行 .msi 安装包后，遵循安装向导的常规提示前进。在此过程中有一个最核心的配置页面：Custom Setup（自定义设置）。在这个界面中，有一项名为 Add to PATH（添加到系统环境变量）。默认状态下该选项是开启的，它会在安装完成时自动将 Node.js 的安装目录（通常是 C:\Program Files\nodejs\）写入系统的系统级 PATH 环境变量中。切勿将其取消勾选。

图1：Windows 下 MSI 安装包自动完成可执行文件写入与 PATH 环境变量登记过程

安装向导执行完毕后，按键盘 Win + R 键，输入 cmd 打开命令提示符，执行以下测试命令：

node -v
npm -v

若屏幕分别输出类似 v20.18.0 和 10.8.2 的版本字符串，说明安装成功且环境变量已经自动就绪。

三、macOS 平台下载、架构差异与环境配置

macOS 下安装 Node.js 主要有两种途径：直接下载官网 .pkg 安装包，或者使用终端包管理器 Homebrew。

1. 官网 .pkg 交互式安装包

下载 macOS 对应的 .pkg 文件后双击，按照提示一步步点击继续。macOS 的 pkg 安装器会将二进制文件写入系统目录，并在系统的标准可执行路径中创建软链接：

• 核心二进制位于：/usr/local/bin/node 和 /usr/local/bin/npm
• 或者对于 Apple Silicon（M 系列芯片）：根据安装工具不同，可能位于 /opt/homebrew/bin/node

2. 芯片架构对路径的影响

现代 Mac 电脑分为两类芯片架构：老款 Intel 处理器（x86_64）和 Apple Silicon（M1/M2/M3/M4 系列，arm64）。这两种架构在 Homebrew 和可执行路径规范上存在明显差异：

图2：macOS 不同硬件平台下的路径规范与 Shell 环境初始化加载逻辑

macOS 从 10.15（Catalina）开始，默认终端 Shell 从 Bash 全面切换为 Zsh。因此，所有的环境变量输出应当写入用户根目录下的 ~/.zshrc 文件，而非旧版教程中常提的 ~/.bash_profile。

四、环境变量配置机制与四大常见问题排查

无论是哪个操作系统，环境变量 PATH 的本质就是一个“路径列表”，各个路径之间在 Windows 下用半角分号 ; 隔开，在 Unix/macOS 下用半角冒号 : 隔开。当你在终端输入 node 时，系统会依次遍历 PATH 中的每一个目录，只要在其中一个目录下找到了名为 node（或 node.exe）的可执行文件，就会立即启动它；如果搜遍所有目录都没有找到，就会报错退出。

图3：命令行无法识别 node / npm 的逐步诊断与排查路径

问题 1：安装完成后，终端提示“'node' 不是内部或外部命令”或“command not found: node”

根本原因：系统当前的 PATH 变量中未包含 Node.js 可执行文件的物理目录。

Windows 解决方法：

1. 按 Win + S 搜索并打开“编辑系统环境变量”。
2. 在弹出的“系统属性”窗口下方点击“环境变量”按钮。
3. 在“系统变量”列表中找到名为 Path 的项，选中后点击“编辑”。
4. 点击右侧“新建”，填入 Node.js 的实际安装路径，例如：C:\Program Files\nodejs\。
5. 一路点击“确定”保存退出。
6. 关闭当前的 CMD 或 PowerShell 窗口，重新打开一个新的窗口，再次执行 node -v。

macOS 解决方法：

打开终端，执行以下命令将 Node.js 所在路径追加到 ~/.zshrc 中（以常见的 /usr/local/bin 为例）：

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

如果使用的是 Apple Silicon 芯片并通过 Homebrew 安装：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

问题 2：修改了环境变量，但命令行依然报同样的错误

根本原因：终端会话的静态快照机制。

环境变量的加载是在进程创建时单次读取的。如果你在修改系统环境变量之前就已经打开了命令行窗口、PowerShell、或者 VS Code / WebStorm 内置终端，这些已经运行的进程持有的是“旧的 PATH 快照”，绝不会动态感知你在操作系统控制面板里的修改。

问题 3：全局安装了包（如 npm install -g pnpm），提示“不是内部或外部命令”

根本原因：Node.js 的可执行目录在 PATH 中，但 npm 的“全局可执行脚本目录”未加入 PATH。

运行 npm install -g <package> 时，生成的 CLI 批处理文件或软链接并不会存放在 node.exe 的同级目录，而是存放在 npm 专门指定的全局 prefix 路径中。

首先在终端查询当前 npm 的全局目录位置：

npm config get prefix

• Windows 常见输出：C:\Users\用户名\AppData\Roaming\npm。此时需要检查系统变量或用户变量中的 Path 是否包含该路径。若缺失，手动将其追加进去。
• macOS 常见输出：/usr/local 或 ~/.npm-global。其可执行文件位于对应路径下的 bin 目录（例如 /usr/local/bin 或 $HOME/.npm-global/bin）。确保将该 bin 目录写入 ~/.zshrc 的 PATH 中。

问题 4：macOS 切换终端工具或从 bash 改为 zsh 后，配置全部失效

根本原因：不同 Shell 加载的配置文件不同。

许多初学者直接照搬旧文档，把 export PATH=... 写入了 ~/.bash_profile 或 ~/.bashrc。然而 macOS 默认启动的 Shell 是 Zsh，它在启动时根本不会读取 .bash_profile。请在终端执行：

echo $SHELL

如果回显输出为 /bin/zsh，说明当前正在使用 Zsh，所有的环境变量配置必须统一放在 ~/.zshrc 文件中。执行 open ~/.zshrc 或 nano ~/.zshrc 检查内容即可。

五、跨平台环境配置要素对比与总结

为便于随时对照查阅，下表与图示系统梳理了 Windows 与 macOS 在 Node.js 环境中的各项关键属性及对应排查点：

图4：双系统核心路径、配置入口及诊断命令横向对比一览

只要按照上述顺序核对路径并保持配置文件的正确性，无论是刚接触前端开发的新环境配置，还是后续安装各类全局 CLI 工具，都能确保命令被操作系统顺畅识别与执行。