首页
/ 正文

Node.js 教程（长文讲解）

更新时间: 2025-04-02 11:24:42

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

前言：Node.js 的重要性与适用场景

在当今的互联网技术生态中，Node.js 已经成为构建高性能服务器端应用的首选工具之一。它不仅简化了前后端技术栈的统一，还凭借其独特的事件驱动架构，在实时通信、微服务架构和数据密集型场景中展现出卓越的性能。无论是开发聊天应用、物联网系统，还是搭建 RESTful API，Node.js 都能提供轻量、高效且灵活的解决方案。本文将通过 循序渐进 的方式，从基础概念到实战案例，为编程初学者和中级开发者提供一份完整的 Node.js 教程。

一、Node.js 的核心概念与运行机制

1.1 什么是 Node.js？

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它允许开发者在服务器端直接运行 JavaScript 代码。与传统的服务器端语言（如 PHP 或 Python）不同，Node.js 的设计哲学是 单线程事件循环驱动，这使其在处理高并发请求时具有显著优势。

比喻说明：
可以将 Node.js 想象为一家高效的快递公司。当收到大量包裹时，传统服务器可能需要为每个包裹分配一位员工（线程），而 Node.js 则像一位经验丰富的调度员，通过事件队列和回调机制，用单线程高效处理所有包裹的分拣、运输和通知，避免了资源浪费。

1.2 核心架构：事件循环与非阻塞 I/O

Node.js 的性能优势源于其 非阻塞 I/O 模型和 事件循环机制。

非阻塞 I/O：所有 I/O 操作（如文件读写、网络请求）均以异步方式执行，避免因等待操作完成而阻塞主线程。
事件循环：主线程持续监听事件队列，一旦有事件（如 HTTP 请求、文件读取完成）触发，便执行对应的回调函数。

代码示例：

// 同步 vs 异步操作对比
// 同步代码：主线程会被阻塞
const fs = require('fs');
const data = fs.readFileSync('file.txt'); // 阻塞主线程直到文件读取完成
console.log(data);

// 异步代码：不阻塞主线程
fs.readFile('file.txt', (err, data) => {
  console.log(data); // 在文件读取完成后执行
});
console.log("继续执行其他任务");

二、环境搭建与第一个 Node.js 程序

2.1 开发环境配置

安装 Node.js 非常简单，只需访问 Node.js 官网下载对应操作系统的安装包。安装完成后，可以通过以下命令验证版本：

node -v  # 查看 Node.js 版本
npm -v   # 查看 npm（包管理器）版本

2.2 编写第一个 Node.js 程序

创建一个名为 app.js 的文件，输入以下代码：

// app.js
console.log("Hello, Node.js!");

运行命令：

node app.js

控制台将输出 Hello, Node.js!，这标志着你的 Node.js 开发环境已成功搭建。

三、核心模块与基础功能

3.1 标准库模块：FS 模块（文件系统）

Node.js 提供了丰富的内置模块，其中 fs 模块用于文件系统操作。以下代码演示了如何读取和写入文件：

const fs = require('fs');

// 异步读取文件
fs.readFile('input.txt', 'utf8', (err, data) => {
  if (err) throw err;
  console.log("文件内容：", data);
});

// 异步写入文件
const content = "这是要写入的内容";
fs.writeFile('output.txt', content, (err) => {
  if (err) throw err;
  console.log("文件写入成功！");
});

3.2 HTTP 模块：构建简单服务器

通过 http 模块，可以快速创建一个 HTTP 服务器：

const http = require('http');

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello, HTTP Server!\n');
});

server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000');
});

四、异步编程与错误处理

4.1 回调函数与回调地狱

Node.js 的异步操作通常通过 回调函数 实现，但嵌套的回调可能导致“回调地狱”问题。例如：

// 示例：回调地狱
fs.readFile('file1.txt', (err, data1) => {
  if (err) throw err;
  fs.readFile(data1.toString(), (err, data2) => {
    if (err) throw err;
    fs.writeFile('output.txt', data2, (err) => {
      if (err) throw err;
      console.log('任务完成');
    });
  });
});

4.2 使用 Promise 与 async/await

通过 util.promisify 或原生 Promise，可以简化异步代码：

const { promisify } = require('util');
const fs = require('fs');
const readFile = promisify(fs.readFile);

async function processFiles() {
  try {
    const data1 = await readFile('file1.txt', 'utf8');
    const data2 = await readFile(data1, 'utf8');
    await fs.promises.writeFile('output.txt', data2);
    console.log("任务完成");
  } catch (err) {
    console.error(err);
  }
}

processFiles();

五、实战案例：构建一个 RESTful API

5.1 案例目标：Todo List API

我们将使用 Express.js（Node.js 的流行框架）创建一个简单的 Todo 列表 API，包含以下端点：

GET /todos：获取所有任务
POST /todos：添加新任务
DELETE /todos/:id：删除指定任务

5.2 项目初始化与依赖安装

mkdir todo-api
cd todo-api
npm init -y
npm install express body-parser

5.3 代码实现

// app.js
const express = require('express');
const bodyParser = require('body-parser');
const app = express();

// 模拟数据库
let todos = [
  { id: 1, text: "学习 Node.js", completed: false },
  { id: 2, text: "完成项目", completed: true }
];

app.use(bodyParser.json());

// 获取所有任务
app.get('/todos', (req, res) => {
  res.json(todos);
});

// 添加任务
app.post('/todos', (req, res) => {
  const newTodo = {
    id: Date.now(),
    text: req.body.text,
    completed: false
  };
  todos.push(newTodo);
  res.status(201).json(newTodo);
});

// 删除任务
app.delete('/todos/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const index = todos.findIndex(todo => todo.id === id);
  if (index === -1) return res.status(404).send("任务不存在");
  todos.splice(index, 1);
  res.sendStatus(204);
});

const PORT = 3000;
app.listen(PORT, () => {
  console.log(`服务运行在 http://localhost:${PORT}`);
});

六、性能优化与高级技巧

6.1 缓存机制

通过缓存频繁访问的数据可以显著提升响应速度。例如，使用 LRU Cache 库缓存数据库查询结果：

const LRU = require('lru-cache');
const cache = new LRU({
  max: 100, // 最大缓存条目
  maxAge: 1000 * 60 * 5 // 缓存 5 分钟
});

function fetchDataFromDB(key) {
  // 模拟数据库查询
  return cache.get(key) || 
    cache.set(key, expensiveDatabaseCall());
}

6.2 集群模式与负载均衡

利用 Node.js 的 cluster 模块实现多核 CPU 利用：

const cluster = require('cluster');
const os = require('os');
const numCPUs = os.cpus().length;

if (cluster.isPrimary) {
  console.log(`主进程 ${process.pid} 正在运行`);
  for (let i = 0; i < numCPUs; i++) {
    cluster.fork();
  }
} else {
  // 启动服务器代码
  require('./app.js');
}

结论：持续学习与进阶方向

通过本文的 Node.js 教程，我们从基础概念到实战案例，逐步掌握了 Node.js 的核心特性与开发技巧。对于初学者，建议从以下方向深入：

框架学习：探索 Express、Koa 等流行框架，理解中间件机制。
数据库集成：学习 MongoDB、PostgreSQL 等数据库的 Node.js 连接方法。
实时应用开发：利用 Socket.IO 实现聊天室或仪表盘。
性能调优：研究 Profiler 工具和内存泄漏检测。

Node.js 的生态仍在快速发展，保持对新版本特性的关注（如 ES Modules 原生支持）将帮助开发者始终站在技术前沿。希望本文能为你开启 Node.js 的学习之旅，并在实际项目中发挥价值！

Node.js 教程（长文讲解）

前言：Node.js 的重要性与适用场景

一、Node.js 的核心概念与运行机制

1.1 什么是 Node.js？

1.2 核心架构：事件循环与非阻塞 I/O

二、环境搭建与第一个 Node.js 程序

2.1 开发环境配置

2.2 编写第一个 Node.js 程序

三、核心模块与基础功能

3.1 标准库模块：FS 模块（文件系统）

3.2 HTTP 模块：构建简单服务器

四、异步编程与错误处理

4.1 回调函数与回调地狱

4.2 使用 Promise 与 async/await

五、实战案例：构建一个 RESTful API

5.1 案例目标：Todo List API

5.2 项目初始化与依赖安装

5.3 代码实现

六、性能优化与高级技巧

6.1 缓存机制

6.2 集群模式与负载均衡

结论：持续学习与进阶方向

最新发布

SQLite 数据类型（一文讲透）

SQLite 创建数据库（保姆级教程）

SQLite 附加数据库（长文讲解）

SQLite 分离数据库（手把手讲解）

SQLite 创建表（建议收藏）

SQLite 删除表（千字长文）

SQLite Insert 语句（长文讲解）

SQLite Select 语句（建议收藏）

SQLite 运算符（手把手讲解）

SQLite 表达式（超详细）