Skip to content

如何安装 Node.js

Node.js 的安装方式多种多样。本文重点介绍几种最常见和最方便的方法。所有主要平台的官方软件包都可以在 https://nodejs.org/download/ 获取。

一种非常方便的安装 Node.js 的方法是通过包管理器。在这种情况下,每个操作系统都有自己的包管理器。

使用包管理器安装

在 macOS、Linux 和 Windows 上,您可以按如下方式安装:

bash
# 安装 nvm (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 下载并安装 Node.js (您可能需要重启终端)
nvm install 20

# 验证正确的 Node.js 版本是否已添加到环境变量
node -v # 应打印 `v20.17.0`

# 验证正确的 npm 版本是否已添加到环境变量
npm -v # 应打印 `10.8.2`
bash
# 安装 fnm (Fast Node Manager)
curl -fsSL https://fnm.vercel.app/install | bash

# 激活 fnm
source ~/.bashrc

# 下载并安装 Node.js
fnm use --install-if-missing 20

# 验证正确的 Node.js 版本是否已添加到环境变量
node -v # 应打印 `v20.17.0`

# 验证正确的 npm 版本是否已添加到环境变量
npm -v # 应打印 `10.8.2`
bash
# 注意:
# Homebrew 不是 Node.js 包管理器。
# 请确保它已安装在您的系统上。
# 请按照 https://brew.sh/ 上的官方说明操作。
# Homebrew 只支持安装主要版本的 Node.js,可能不支持 20 版本系列中的最新 Node.js 版本。

# 下载并安装 Node.js
brew install node@20

# 验证正确的 Node.js 版本是否已添加到环境变量
node -v # 应打印 `v20.17.0`

# 验证正确的 npm 版本是否已添加到环境变量
npm -v # 应打印 `10.8.2`
bash
# 注意:
# Docker 不是 Node.js 包管理器。
# 请确保它已安装在您的系统上。
# 请按照 https://docs.docker.com/desktop/ 上的官方说明操作。
# Docker 镜像由 https://github.com/nodejs/docker-node/ 官方提供。

# 拉取 Node.js Docker 镜像
docker pull node:20-alpine

# 验证正确的 Node.js 版本是否已添加到环境变量
docker run node:20-alpine node -v # 应打印 `v20.17.0`

# 验证正确的 npm 版本是否已添加到环境变量
docker run node:20-alpine npm -v # 应打印 `10.8.2`

在 Windows 上,您可以按如下方式安装:

bash
# 安装 fnm (Fast Node Manager)
winget install Schniz.fnm

# 配置 fnm 环境
fnm env --use-on-cd | Out-String | Invoke-Expression

# 下载并安装 Node.js
fnm use --install-if-missing 20

# 验证正确的 Node.js 版本是否已添加到环境变量
node -v # 应打印 `v20.17.0`

# 验证正确的 npm 版本是否已添加到环境变量
npm -v # 应打印 `10.8.2`
bash
# 注意:
# Chocolatey 不是 Node.js 包管理器。
# 请确保它已安装在您的系统上。
# 请按照 https://chocolatey.org/ 上的官方说明操作。
# Chocolatey 不是由 Node.js 项目官方维护的,可能不支持 Node.js 的 v20.17.0 版本。

# 下载并安装 Node.js
choco install nodejs-lts --version="20.17.0"

# 验证正确的 Node.js 版本是否已添加到环境变量
node -v # 应打印 `20`

# 验证正确的 npm 版本是否已添加到环境变量
npm -v # 应打印 `10.8.2`
bash
# 注意:
# Docker 不是 Node.js 包管理器。
# 请确保它已安装在您的系统上。
# 请按照 https://docs.docker.com/desktop/ 上的官方说明操作。
# Docker 镜像由 https://github.com/nodejs/docker-node/ 官方提供。

# 拉取 Node.js Docker 镜像
docker pull node:20-alpine

# 验证正确的 Node.js 版本是否已添加到环境变量
docker run node:20-alpine node -v # 应打印 `v20.17.0`

# 验证正确的 npm 版本是否已添加到环境变量
docker run node:20-alpine npm -v # 应打印 `10.8.2`

nvm 是运行 Node.js 的一种流行方式。它允许您轻松切换 Node.js 版本,并安装新版本进行尝试,如果出现问题则可以轻松回滚。它对于使用旧版 Node.js 版本测试代码也非常有用。

TIP

有关此选项的更多信息,请参见 https://github.com/nvm-sh/nvm

无论哪种方式,安装 Node.js 后,您都可以在命令行中访问 node 可执行程序。