Node.js 安装教程

概述

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，用于构建服务器端和网络应用。本文档将详细介绍如何在不同操作系统上安装 Node.js。

版本选择

根据官方下载页面，Node.js 提供以下主要版本：

• LTS 版本：长期支持版本，稳定性高，适合生产环境

  • v24.14.0 (LTS)
  • v22.22.0 (LTS)
  • v20.20.0 (LTS)

• Current 版本：最新版本，包含最新特性，适合开发和测试

  • v25.7.0 (Current)

Windows 平台安装

方法一：使用安装程序

1. 下载安装包

   • 访问 Node.js 官方下载页面
   • 选择适合你系统的 Windows Installer (.msi) 文件
   • 对于 64 位系统，选择 64-bit 版本
   • 对于 32 位系统，选择 32-bit 版本

2. 运行安装程序

   • 双击下载的 .msi 文件
   • 按照安装向导的提示进行操作
   • 建议使用默认安装选项
   • 确保勾选 “Add to PATH” 选项，这样可以在命令行中直接使用 node 和 npm 命令

3. 验证安装

   • 打开命令提示符（CMD）或 PowerShell
   • 运行以下命令检查 Node.js 版本：

     1 2	node -v # 应显示类似 v24.14.0 的版本号

   • 运行以下命令检查 npm 版本：

     1 2	npm -v # 应显示类似 11.9.0 的版本号

方法二：使用独立二进制文件

1. 下载独立二进制文件

   • 访问 Node.js 官方下载页面
   • 选择 Standalone Binary (.zip) 文件

2. 解压并配置

   • 解压下载的 .zip 文件到你选择的目录
   • 将该目录添加到系统环境变量 PATH 中

3. 验证安装

   • 按照方法一中的验证步骤进行检查

macOS 平台安装

方法一：使用安装程序

1. 下载安装包

   • 访问 Node.js 官方下载页面
   • 选择适合 macOS 的安装包

2. 运行安装程序

   • 双击下载的 .pkg 文件
   • 按照安装向导的提示进行操作

3. 验证安装

   • 打开终端
   • 运行以下命令检查版本：

     1 2	node -v npm -v

方法二：使用 Homebrew

1
2
3
4
5
6

# 安装 Node.js
brew install node

# 验证安装
node -v
npm -v

Linux 平台安装

方法一：使用包管理器

Ubuntu/Debian

1
2
3
4
5
6
7
8
9

# 更新包列表
sudo apt update

# 安装 Node.js 和 npm
sudo apt install nodejs npm

# 验证安装
node -v
npm -v

CentOS/RHEL

1
2
3
4
5
6

# 安装 Node.js
sudo dnf install nodejs

# 验证安装
node -v
npm -v

方法二：使用 nvm (Node Version Manager)

1. 安装 nvm

   1 2 3

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

2. 重启终端或执行

   1	source ~/.bashrc

3. 安装 Node.js

   1 2 3 4 5 6 7 8

   # 安装最新 LTS 版本 nvm install --lts # 安装特定版本 nvm install 24.14.0 # 切换使用的版本 nvm use 24.14.0

4. 验证安装

   1 2	node -v npm -v

Docker 容器化部署

拉取 Node.js 镜像

1
2
3
4
5

# 拉取 Node.js 24 Alpine 版本（轻量级）
docker pull node:24-alpine

# 拉取特定版本
docker pull node:24.14.0-alpine

运行 Node.js 容器

1
2
3
4
5
6

# 运行容器并启动 Shell 会话
docker run -it --rm --entrypoint sh node:24-alpine

# 在容器中验证 Node.js 版本
node -v  # 应显示 v24.14.0
npm -v   # 应显示 11.9.0

创建 Node.js 应用容器

创建 Dockerfile：

1
2
3
4
5
6
7
8
9
10
11

FROM node:24-alpine

WORKDIR /app

COPY package*.json ./
RUN npm install

COPY . .

EXPOSE 3000
CMD ["node", "app.js"]

构建和运行：

1
2

docker build -t my-node-app .
docker run -p 3000:3000 my-node-app

验证安装

无论使用哪种安装方法，安装完成后都应该验证 Node.js 和 npm 是否正确安装：

1
2
3
4
5
6
7
8

# 检查 Node.js 版本
node -v

# 检查 npm 版本
npm -v

# 运行一个简单的 Node.js 脚本
node -e "console.log('Hello, Node.js!')"

常见问题及解决方案

权限问题

在 Linux/macOS 上安装全局包时可能遇到权限问题：

1
2
3
4
5
6
7

# 解决方案 1：使用 sudo
 sudo npm install -g package-name

# 解决方案 2：修改 npm 全局目录权限
npm config set prefix ~/.npm
echo 'export PATH="$HOME/.npm/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

版本管理

如果需要在同一台机器上使用多个 Node.js 版本，推荐使用 nvm：

• Windows：使用 nvm-windows
• Linux/macOS：使用 nvm

网络问题

如果下载速度慢，可以使用国内镜像：

1
2
3
4
5

# 设置 npm 镜像
npm config set registry https://registry.npmmirror.com

# 或使用 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

总结

Node.js 提供了多种安装方式，适合不同的操作系统和使用场景：

• Windows/macOS：推荐使用官方安装程序，简单快捷
• Linux：推荐使用包管理器或 nvm
• 容器环境：推荐使用 Docker 镜像

选择合适的安装方法，并根据实际需求选择 LTS 版本或 Current 版本。安装完成后，你就可以开始使用 Node.js 开发各种应用了！