目录
引言
第一部分：Node.js 简介与版本选择
1.1 什么是 Node.js？
1.2 Node.js 版本介绍
第二部分：Node.js 安装方式详解
2.1 方式一：官方安装包（最简单，适合初学者）
Windows/macOS 安装步骤：
2.2 方式二：包管理器安装（适合 Linux 用户）
Ubuntu/Debian 系统安装步骤：
CentOS/RHEL 系统安装步骤：
macOS 使用 Homebrew 安装：
2.3 方式三：使用 NVM 安装（最推荐，适合多版本管理）
NVM 安装步骤：
使用 NVM 管理 Node.js 版本：
第三部分：Node.js 环境配置
3.1 配置 npm 镜像加速（国内用户必做）
3.2 全局包安装位置配置（可选）
3.3 安装常用的全局工具
3.4 npm 镜像管理工具 nrm 的使用
第四部分：验证安装与第一个 Node.js 程序
4.1 创建第一个 Node.js 服务器
4.2 运行程序
4.3 创建第一个 npm 项目
第五部分：常见问题与故障排查
5.1 安装过程中的常见问题
5.2 Windows 特有注意事项
5.3 升级 Node.js 和 npm
第六部分：Node.js 生态系统概览
6.1 包管理工具
6.2 开发框架
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：双击下载的
- 验证安装：打开终端（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 -v
CentOS/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 -v
macOS 使用 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 -v
2.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.7
Windows 系统：
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.0
NVM 常用命令速查表：
| 命令 | 说明 |
|---|---|
| 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.com
3.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 ~/.bashrc
3.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=0
3.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]
《Node.js 安装与配置完全指南：从零开始搭建开发环境》 是转载文章，点击查看原文。
