Node.js 安装（多平台详细教程）

在开始使用 Node.js 之前，必须先在您的计算机上安装它。本章将详细介绍在不同操作系统上安装 Node.js 的多种方法，包括官方安装包、包管理器以及版本管理工具 nvm。您可以根据自己的需求选择最合适的方式。

一、使用官方安装包（最简单）

访问 Node.js 官网，首页会提供两个版本：LTS（长期支持版） 和 Current（最新尝鲜版）。对于大多数用户，建议下载 LTS 版本以获得更好的稳定性和兼容性。

Windows 系统

1 在官网点击 Windows 安装包（.msi 文件），根据系统位数选择 64-bit 或 32-bit。
2 下载完成后，双击运行安装程序。
3 欢迎界面点击 Next，阅读许可协议并勾选接受。
4 选择安装路径（默认即可），点击 Next。
5 选择要安装的组件，通常保持默认（包括 npm 和添加到 PATH）。
6 点击 Install 开始安装，完成后点击 Finish。

提示： 安装过程中会自动将 Node.js 和 npm 添加到系统环境变量 PATH 中，安装完成后打开命令提示符即可直接使用 node 和 npm 命令。

macOS 系统

1 在官网点击 macOS 安装包（.pkg 文件）。
2 打开下载的 .pkg 文件，按照安装向导的提示进行操作（通常一路继续即可）。
3 安装完成后，打开终端，输入 node -v 验证安装。

此外，macOS 用户还可以通过 Homebrew 安装（见下文包管理器方式）。

Linux 系统（以 Ubuntu/Debian 为例）

官方提供了适用于 Linux 的二进制文件，但更推荐使用包管理器或 nodesource 仓库安装。

# 使用 nodesource 提供的安装脚本（推荐）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node -v
npm -v

对于其他发行版（如 CentOS、Fedora），请参考官方文档。

二、使用包管理器安装

各操作系统的包管理器也提供了 Node.js 安装包，方便与系统其他软件统一管理。

macOS（Homebrew）

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

# 验证
node -v
npm -v

Linux（不同发行版）

Ubuntu/Debian： 使用 apt（但版本可能较旧，建议用 nodesource）
CentOS/RHEL： 使用 yum 或 dnf，同样推荐 nodesource 仓库
Arch Linux： sudo pacman -S nodejs npm

Windows（Chocolatey 或 winget）

如果你使用包管理器 Chocolatey：

# 以管理员身份打开 PowerShell，先安装 Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 安装 Node.js LTS 版本
choco install nodejs-lts

# 或者安装最新版
choco install nodejs

Windows 11/10 也内置了 winget：

winget install OpenJS.NodeJS.LTS   # LTS 版
winget install OpenJS.NodeJS        # 最新版

三、使用 nvm 管理多版本（推荐开发者使用）

nvm（Node Version Manager）允许你在同一台机器上安装和切换多个 Node.js 版本，非常适合需要测试不同环境或同时维护多个项目的开发者。

安装 nvm

macOS / Linux：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 或者使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完成后，重新打开终端或执行 source ~/.bashrc（或 ~/.zshrc）使 nvm 命令生效。

Windows： 可以使用 nvm-windows，从 GitHub 发布页下载 nvm-setup.exe 安装。

使用 nvm 安装 Node.js

# 查看可安装的版本
nvm list available          # Windows 下为 nvm list available
# 或者
nvm ls-remote               # macOS/Linux

# 安装特定版本，例如 18.17.0
nvm install 18.17.0

# 安装最新 LTS 版本
nvm install --lts

# 切换到已安装的版本
nvm use 18.17.0

# 设置默认版本
nvm alias default 18.17.0

# 查看已安装版本
nvm list

注意： 使用 nvm 安装的 Node.js 会独立管理每个版本的全局 npm 包，切换版本时全局包不会共享。

四、验证安装

无论通过哪种方式安装，安装完成后都可以通过以下命令验证是否成功：

node -v
# 输出示例：v18.17.0

npm -v
# 输出示例：9.6.7

如果显示出对应的版本号，说明 Node.js 和 npm 已经正确安装并配置了环境变量。

五、配置 npm（可选）

npm 默认的官方源在国外，国内用户可能会遇到速度慢的问题，可以配置为淘宝镜像：

# 临时使用
npm --registry https://registry.npmmirror.com install express

# 永久配置
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry

也可以使用 cnpm 工具：npm install -g cnpm --registry=https://registry.npmmirror.com，之后使用 cnpm 命令代替 npm。

六、常见问题

Windows 上出现“node 不是内部或外部命令”：可能未将 Node.js 添加到 PATH，请重新安装并确保勾选“Add to PATH”，或手动添加安装目录（如 C:\Program Files\nodejs\）到系统环境变量。
macOS 提示“权限不足”：使用 sudo 安装全局包，或者使用 nvm 避免权限问题。
Linux 上使用 apt 安装的版本太旧：建议使用 nodesource 仓库或 nvm 安装最新版。

小结

现在你已经成功安装了 Node.js 和 npm！接下来我们将编写第一个 Node.js 程序，体验 JavaScript 在服务器端的魅力。如果你在安装过程中遇到任何问题，欢迎在评论区留言讨论。

上一章: 简介下一章: 第一个Node程序

Node.js教程