目录
[第一部分：Node.js 简介与版本选择](#第一部分：Node.js 简介与版本选择)
[1.1 什么是 Node.js？](#1.1 什么是 Node.js？)
[1.2 Node.js 版本介绍](#1.2 Node.js 版本介绍)
[第二部分：Node.js 安装方式详解](#第二部分：Node.js 安装方式详解)
[2.1 方式一：官方安装包（最简单，适合初学者）](#2.1 方式一：官方安装包（最简单，适合初学者）)
[Windows/macOS 安装步骤：](#Windows/macOS 安装步骤：)
[2.2 方式二：包管理器安装（适合 Linux 用户）](#2.2 方式二：包管理器安装（适合 Linux 用户）)
[Ubuntu/Debian 系统安装步骤：](#Ubuntu/Debian 系统安装步骤：)
[CentOS/RHEL 系统安装步骤：](#CentOS/RHEL 系统安装步骤：)
[macOS 使用 Homebrew 安装：](#macOS 使用 Homebrew 安装：)
[2.3 方式三：使用 NVM 安装（最推荐，适合多版本管理）](#2.3 方式三：使用 NVM 安装（最推荐，适合多版本管理）)
[NVM 安装步骤：](#NVM 安装步骤：)
[使用 NVM 管理 Node.js 版本：](#使用 NVM 管理 Node.js 版本：)
[第三部分：Node.js 环境配置](#第三部分：Node.js 环境配置)
[3.1 配置 npm 镜像加速（国内用户必做）](#3.1 配置 npm 镜像加速（国内用户必做）)
[3.2 全局包安装位置配置（可选）](#3.2 全局包安装位置配置（可选）)
[3.3 安装常用的全局工具](#3.3 安装常用的全局工具)
[3.4 npm 镜像管理工具 nrm 的使用](#3.4 npm 镜像管理工具 nrm 的使用)
[第四部分：验证安装与第一个 Node.js 程序](#第四部分：验证安装与第一个 Node.js 程序)
[4.1 创建第一个 Node.js 服务器](#4.1 创建第一个 Node.js 服务器)
[4.2 运行程序](#4.2 运行程序)
[4.3 创建第一个 npm 项目](#4.3 创建第一个 npm 项目)
[5.1 安装过程中的常见问题](#5.1 安装过程中的常见问题)
[5.2 Windows 特有注意事项](#5.2 Windows 特有注意事项)
[5.3 升级 Node.js 和 npm](#5.3 升级 Node.js 和 npm)
[第六部分：Node.js 生态系统概览](#第六部分：Node.js 生态系统概览)
[6.1 包管理工具](#6.1 包管理工具)
[6.2 开发框架](#6.2 开发框架)
[6.3 开发工具](#6.3 开发工具)
引言
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它让 JavaScript 突破了浏览器的限制，能够运行在服务器端。无论你是前端开发者想要搭建构建工具，还是后端开发者准备构建高性能网络应用，安装和配置 Node.js 都是迈向现代 JavaScript 开发的第一步。
本文将带你手把手完成 Node.js 的安装与配置，并提供多种安装方式的对比，让你根据自己的需求选择最合适的方法。
第一部分：Node.js 简介与版本选择
1.1 什么是 Node.js？
Node.js 是一个开源、跨平台的 JavaScript 运行时环境，它具有以下核心特点：
-
事件驱动：基于事件循环机制，高效处理并发请求
-
非阻塞 I/O：I/O 操作不会阻塞线程，提高资源利用率
-
单线程：但通过事件循环处理并发，避免了多线程的复杂性
-
npm 生态：全球最大的开源库生态系统，拥有超过百万个可复用的包
1.2 Node.js 版本介绍
Node.js 有两个主要版本系列：
| 版本类型 | 特点 | 适用场景 |
|---|---|---|
| LTS（长期支持版） | 稳定、经过充分测试，长期维护 | 生产环境、企业级应用 |
| Current（当前版） | 包含最新特性，但可能不够稳定 | 尝鲜、实验性项目 |
建议 ：对于绝大多数开发者，尤其是初学者，选择 LTS 版本是最稳妥的选择。
第二部分：Node.js 安装方式详解
根据你的操作系统和使用习惯，有多种安装 Node.js 的方式。以下是完整的安装知识树：
text
Node.js 安装方式
│
├── 方式一：官方安装包（适合 Windows/macOS 初学者）
│ ├── 1. 访问官网下载
│ ├── 2. 运行安装程序
│ └── 3. 验证安装
│
├── 方式二：包管理器安装（适合 Linux/macOS）
│ ├── Ubuntu/Debian：apt + NodeSource
│ ├── CentOS/RHEL：yum + NodeSource
│ └── macOS：Homebrew
│
└── 方式三：版本管理工具安装（推荐，适合多项目开发）
├── nvm（Node Version Manager）
├── n（简化版版本管理）
└── fnm（跨平台快速版本管理）2.1 方式一：官方安装包（最简单，适合初学者）
这是 Windows 和 macOS 用户最直接的安装方式。
Windows/macOS 安装步骤：
-
访问官网下载页面 ：打开 Node.js 官方网站
-
选择 LTS 版本：点击左侧写着"推荐多数用户使用（LTS）"的按钮下载安装包
-
运行安装程序：
-
Windows：双击下载的
.msi文件，按提示点击"下一步"即可（可以自定义安装目录） -
macOS：双击下载的
.pkg文件，按照安装向导完成安装
-
-
验证安装：打开终端（Windows 上是命令提示符或 PowerShell），输入以下命令：
bash
node -v # 输出示例：v20.11.0（LTS 版本号） npm -v # 输出示例：10.2.4
2.2 方式二：包管理器安装（适合 Linux 用户）
如果你使用的是 Linux 系统，可以通过包管理器来安装 Node.js。
Ubuntu/Debian 系统安装步骤：
bash
# 1. 更新系统包列表
sudo apt update
# 2. 使用 NodeSource 仓库安装 LTS 版本（推荐）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
# 3. 验证安装
node -v
npm -vCentOS/RHEL 系统安装步骤：
bash
# 1. 更新系统
sudo yum update -y
# 2. 启用 NodeSource 仓库（以 Node.js 20 LTS 为例）
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
# 3. 安装 Node.js
sudo yum install -y nodejs
# 4. 验证安装
node -v
npm -vmacOS 使用 Homebrew 安装：
bash
# 1. 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 使用 Homebrew 安装 Node.js
brew install node
# 3. 验证安装
node -v
npm -v2.3 方式三：使用 NVM 安装（最推荐，适合多版本管理）
为什么推荐 NVM？ 在实际开发中，你可能会遇到需要在不同项目中使用不同 Node.js 版本的情况。NVM（Node Version Manager）允许你在同一台机器上安装和切换多个 Node.js 版本，每个项目都可以使用最适合的版本。
NVM 安装步骤：
macOS/Linux 系统：
bash
# 1. 下载并安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 2. 重新加载环境变量
source ~/.bashrc # 如果使用 bash
# 或
source ~/.zshrc # 如果使用 zsh
# 3. 验证 NVM 安装
nvm --version
# 输出示例：0.39.7Windows 系统 ：
Windows 用户需要使用 nvm-windows，从 GitHub releases 页面下载安装程序即可。
使用 NVM 管理 Node.js 版本：
bash
# 1. 查看所有可用的 Node.js 版本
nvm list-remote
# 2. 安装指定的 LTS 版本
nvm install --lts # 安装最新的 LTS 版本
# 或指定具体版本
nvm install 20.11.0 # 安装 Node.js 20.11.0
nvm install 18.19.0 # 安装 Node.js 18.19.0
# 3. 查看已安装的版本
nvm ls
# 输出示例：
# -> v20.11.0
# v18.19.0
# 4. 切换使用版本
nvm use 18.19.0 # 切换到 Node.js 18.19.0
nvm use 20.11.0 # 切换回 Node.js 20.11.0
# 5. 设置默认版本（新终端会话自动使用）
nvm alias default 20.11.0
# 6. 卸载不需要的版本
nvm uninstall 18.19.0NVM 常用命令速查表：
| 命令 | 说明 |
|---|---|
nvm install <version> |
安装指定版本 |
nvm use <version> |
切换使用版本 |
nvm ls |
列出已安装版本 |
nvm ls-remote |
列出所有可安装版本 |
nvm alias default <version> |
设置默认版本 |
nvm uninstall <version> |
卸载指定版本 |
nvm current |
查看当前使用的版本 |
第三部分：Node.js 环境配置
安装完成后，还需要进行一些基础配置，让开发体验更顺畅。
3.1 配置 npm 镜像加速（国内用户必做）
由于网络原因，国内用户直接使用 npm 官方源可能会很慢，建议配置为淘宝镜像：
bash
# 设置为淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证配置是否生效
npm config get registry
# 应输出：https://registry.npmmirror.com3.2 全局包安装位置配置（可选）
如果你希望自定义全局包的安装位置，可以这样配置：
bash
# 查看当前全局包安装位置
npm root -g
# 自定义全局包安装目录（以 macOS/Linux 为例）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 将新目录添加到 PATH 环境变量
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc3.3 安装常用的全局工具
bash
# 安装 yarn（另一个流行的包管理器）
npm install -g yarn
# 安装 PM2（生产进程管理器，用于守护 Node.js 应用）
npm install -g pm2
# 安装 nodemon（开发工具，文件变化时自动重启应用）
npm install -g nodemon
# 安装 TypeScript（如果使用 TypeScript 开发）
npm install -g typescript
# 安装 nrm（npm 镜像管理工具）
npm install -g nrm
# 查看已安装的全局包
npm list -g --depth=03.4 npm 镜像管理工具 nrm 的使用
nrm 可以让你轻松切换不同的 npm 镜像源：
bash
# 查看所有可用镜像
nrm ls
# 输出示例：
# npm -------- https://registry.npmjs.org/
# yarn ------- https://registry.yarnpkg.com/
# tencent ---- https://mirrors.cloud.tencent.com/npm/
# * taobao ----- https://registry.npmmirror.com/
# npmMirror -- https://skimdb.npmjs.com/registry/
# 切换镜像
nrm use taobao
# 测试镜像速度
nrm test taobao第四部分：验证安装与第一个 Node.js 程序
4.1 创建第一个 Node.js 服务器
以下代码创建一个简单的 HTTP 服务器，当访问时返回"Hello World"：
javascript
// 创建文件 server.js
const http = require('http');
// 创建服务器
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain' });
res.end('Hello World\n');
});
// 监听端口
const port = 3000;
server.listen(port, () => {
console.log(`服务器运行在 http://localhost:${port}/`);
});4.2 运行程序
bash
# 在 server.js 所在目录执行
node server.js
# 控制台输出：服务器运行在 http://localhost:3000/打开浏览器访问 http://localhost:3000，如果看到"Hello World"，说明 Node.js 安装成功并可以正常运行。
4.3 创建第一个 npm 项目
bash
# 1. 创建项目目录
mkdir my-first-project
cd my-first-project
# 2. 初始化项目，创建 package.json
npm init -y
# -y 参数使用默认配置，不加则会交互式询问项目信息
# 3. 安装一个依赖包（例如 express 框架）
npm install express
# 4. 查看 package.json，会发现 dependencies 中已添加 express
cat package.json第五部分：常见问题与故障排查
5.1 安装过程中的常见问题
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
node -v 提示找不到命令 |
未添加到 PATH | 重新安装并确保勾选"添加到 PATH"；或手动添加环境变量 |
| npm 安装包很慢 | 网络问题 | 配置淘宝镜像：npm config set registry https://registry.npmmirror.com |
| nvm 命令找不到 | 环境变量未加载 | 执行 source ~/.bashrc 或重新打开终端 |
| Windows 下 nvm 切换版本失败 | 权限不足 | 以管理员身份打开 PowerShell 或命令提示符 |
| 安装包时出现权限错误 | 权限问题 | 避免使用 sudo，改用 nvm 管理版本；或修改 npm 全局目录权限 |
5.2 Windows 特有注意事项
-
安装路径不能包含中文或空格，否则可能导致 nvm 切换版本失败
-
如果遇到权限问题，搜索"Windows PowerShell"并以管理员身份运行
-
nvm-windows 的配置文件
setting.txt中的路径需要与实际安装路径一致
5.3 升级 Node.js 和 npm
bash
# 更新 npm 到最新版本
npm install -g npm@latest
# 如果使用 nvm，升级 Node.js 版本
nvm install 20.11.0 # 安装新版本
nvm alias default 20.11.0 # 设置为默认
# 如果使用官方安装包，直接下载新版本安装包覆盖安装即可第六部分：Node.js 生态系统概览
成功安装 Node.js 后，你就拥有了整个 JavaScript 生态系统的入场券。以下是你可以探索的方向：
6.1 包管理工具
| 工具 | 说明 | 安装命令 |
|---|---|---|
| npm | Node.js 默认包管理器 | 随 Node.js 一起安装 |
| yarn | Facebook 开发的快速、可靠的包管理器 | npm install -g yarn |
| pnpm | 高性能、节省磁盘空间的包管理器 | npm install -g pnpm |
6.2 开发框架
-
Web 框架：Express、Koa、NestJS、Fastify
-
全栈框架：Next.js、Nuxt.js、Remix
-
API 框架：Apollo Server（GraphQL）、tRPC
6.3 开发工具
-
进程管理：PM2（生产环境守护进程）
-
调试工具：Node.js Inspector、Chrome DevTools
-
测试框架：Jest、Mocha、Vitest
总结
本文详细介绍了 Node.js 的安装与配置，从版本选择到多种安装方式，再到环境配置和第一个程序的运行。根据你的需求，可以选择最适合的安装方式：
-
初学者 / Windows/macOS 用户：官方安装包最简单直接
-
Linux 用户：包管理器安装（推荐 NodeSource 仓库）
-
多项目开发 / 进阶用户 ：强烈推荐 NVM，可以灵活切换版本
无论选择哪种方式，安装完成后，你都应该能够成功运行 node -v 和 npm -v，并能创建第一个 Node.js 服务器。Node.js 的世界已经向你敞开，接下来就可以开始探索 Express、构建 API、开发全栈应用了。
参考资料
-
Node.js 官方网站：https://nodejs.org/[citation:9]
-
npm 官方文档：https://docs.npmjs.com/[citation:7]
-
nvm GitHub 仓库：https://github.com/nvm-sh/nvm[citation:3]
-
淘宝 npm 镜像：https://npmmirror.com/[citation:2]