序言 ​

实战：将知识转化为能力的唯一途径 ​

你已经学习了 Node.js 的核心原理，掌握了文件系统和网络编程，理解了框架设计和数据库操作，甚至研究了安全和微服务架构。但有一个关键问题：你真的能独立完成一个完整的项目吗？

学习编程就像学习游泳——你可以读完所有关于游泳的书，看完所有教学视频，但如果不跳进水里，你永远学不会游泳。

这本书，就是那个"游泳池"。

为什么需要完整项目实战 ​

碎片化的学习有其局限性：

• 你可能知道如何写一个 API，但不知道如何组织整个项目结构
• 你可能理解认证原理，但不知道如何从零实现完整的登录系统
• 你可能学过数据库操作，但不知道如何设计真实的数据模型
• 你可能了解错误处理，但不知道如何建立完整的错误处理体系

只有通过完整项目的开发，你才能将这些碎片化的知识串联起来，形成真正的工程能力。

本书的项目设计理念 ​

1. 真实场景驱动 ​

本书的每个项目都源自真实的业务场景：CLI 脚手架工具是每个团队的基础设施，RESTful API 是后端开发的核心技能，实时通信支撑着现代应用的互动体验。

2. 渐进式复杂度 ​

项目从简单到复杂依次排列。前几个项目帮助你建立信心，后续项目逐步引入更高级的概念和挑战。

3. 生产级质量 ​

每个项目都按照生产环境的标准来开发：完整的错误处理、合理的项目结构、必要的测试覆盖、清晰的文档。这不是玩具项目，而是可以直接部署上线的真实应用。

4. 端到端完整 ​

从需求分析到系统设计，从编码实现到测试部署，每个项目都会走完完整的开发流程。你不仅学会"怎么写"，还会理解"为什么这样写"。

项目概览 ​

项目一：现代 CLI 脚手架工具 ​

类似 create-vite 的交互式脚手架，包含模板选择、配置生成、依赖安装等完整功能。

你将学到：命令行交互、文件模板渲染、npm 包发布

项目二：RESTful API 服务 ​

完整的用户认证系统，包含注册、登录、权限控制、密码重置等核心功能。

你将学到：API 设计、JWT 认证、RBAC 权限、数据验证

项目三：实时聊天应用 ​

基于 WebSocket 的实时聊天室，支持多房间、私聊、消息持久化。

你将学到：WebSocket 通信、Socket.io、实时数据同步

项目四：任务调度系统 ​

支持定时任务、延迟任务、任务重试的调度系统。

你将学到：消息队列、任务调度、分布式锁

项目五：文件服务 ​

大文件上传、断点续传、图片处理的完整文件服务。

你将学到：流式处理、分片上传、云存储集成

项目六：博客系统 ​

完整的内容管理系统，包含文章发布、评论、搜索等功能。

你将学到：全栈开发、SEO 优化、全文搜索

本书结构 ​

每个项目都按照相同的结构组织：

1. 需求分析：明确项目目标和功能范围
2. 系统设计：架构设计、数据模型、API 设计
3. 核心实现：逐步实现核心功能
4. 进阶功能：扩展更多实用特性
5. 测试与部署：编写测试、部署上线

目标读者 ​

本书适合：

• 完成了 Node.js 基础学习，想要实战练手的开发者
• 有其他语言后端经验，想通过项目快速掌握 Node.js 的工程师
• 准备求职面试，需要完整项目经验的候选人
• 想要扩展自己技术栈的前端开发者

本书假设你已经熟悉 JavaScript/TypeScript，了解 Node.js 基础，有基本的 Web 开发经验。

技术约定 ​

• 基于 Node.js v20 LTS
• 使用 TypeScript
• 框架选择：Express/Fastify/NestJS（根据项目特点选择最合适的）
• 数据库：PostgreSQL、MongoDB、Redis
• 提供完整的源代码仓库

动手开始 ​

最好的学习方式是边读边做。建议你：

1. 先通读项目概述，了解整体目标
2. 跟随书中步骤，一步步实现功能
3. 遇到问题时，先尝试自己解决，再参考书中方案
4. 完成基础功能后，尝试添加自己的创新点
5. 将项目部署上线，形成自己的作品集

让我们开始创造真正的应用。