文档说明
作者：痴者工良
在线阅读：
https://docs.whuanle.cn/zh/learnkafka
作者博客地址：
https://www.cnblogs.com/whuanle
导读
本教程围绕 Kafka 的基础概念和 C#/.NET 客户端实践展开，目标不是只讲抽象原理，而是通过“先把环境搭起来，再逐步写出生产者和消费者”的方式，帮助读者在动手中理解 Kafka 的核心机制。
Kafka 是一个高吞吐、可持久化、可扩展的分布式消息系统。它常被用在日志采集、异步解耦、流式处理、事件驱动、削峰填谷等场景里。但 Kafka 的学习门槛并不低：除了主题、分区、副本、消费者组这些基础概念外，还要理解消息顺序、位点提交、再均衡、可靠性配置等工程细节。
这份教程选择从 .NET 实践切入，使用 Confluent.Kafka 客户端边写边学，把常见的 Kafka 能力落到具体代码和实验场景中。这样你不仅能理解“Kafka 是什么”，也能更快进入“Kafka 在项目里应该怎么用”。
当前内容范围
当前文档已经覆盖这些内容：
- 使用 Docker 部署 Kafka 学习环境；
- 理解 Kafka 中 Topic、Partition、Broker、Producer、Consumer 等概念；
- 使用
.NET客户端连接 Kafka 并完成基础操作； - 编写生产者程序，理解发送流程、配置和可靠性问题；
- 编写消费者程序，理解消费者组、位点和消费行为。
这套内容更适合作为 Kafka 的入门实践笔记和 .NET 客户端学习入口。相比完整的大而全教程，它更强调“先理解核心，再自己扩展”。
本教程适合哪些读者
- 想学习 Kafka 基础知识的 .NET 开发者；
- 希望从代码实践角度理解消息系统的读者；
- 想快速搭建 Kafka 本地实验环境并完成基本收发测试的开发者；
- 对 Kafka 感兴趣，但暂时不想一上来就啃大量 Java 生态资料的读者。
学习前建议
为了更顺畅地阅读本教程，建议你至少具备以下基础：
- 了解 Docker 的基本使用方式；
- 了解消息队列、发布/订阅、异步通信的基础概念；
- 能使用
dotnet命令创建和运行 C# 项目； - 对网络服务、端口、容器之间通信有基本认知。
如果你已经有 RabbitMQ 或其它 MQ 的使用经验，那么理解 Kafka 的“分区、消费者组、位点提交”会更快一些；如果完全没有消息系统基础，也可以把这份教程作为第一份实践材料。
你将学到什么
学习完当前这部分内容后，你可以掌握：
- Kafka 的基础术语和核心结构；
- 如何快速部署单机或集群学习环境；
- 如何在
.NET中使用Confluent.Kafka编写生产者和消费者； - 如何理解消息发送、消费、位点提交和消费者组之间的关系；
- 如何从客户端配置角度思考可靠性、性能与故障处理。
推荐阅读顺序
如果你是第一次接触 Kafka，建议按下面的顺序阅读：
- 先阅读“搭建 Kafka 环境”，把实验环境准备好；
- 再阅读“Kafka 概念”，先建立 Topic、Partition、Broker、Consumer Group 的整体认识；
- 接着阅读“Kafka .NET 基础”，先学会最基础的客户端连接和管理方式；
- 然后阅读“生产者”，理解消息是如何被发送、确认和重试的；
- 最后阅读“消费者”，理解 Kafka 的消费模型和消费者组协作方式。
这样阅读，会比直接从参数配置或高级特性入手更容易形成完整概念。
阅读与实践建议
- 建议每看完一章都亲手做一次实验，不要只看代码片段；
- 学习 Kafka 时，尽量把“概念图”和“实际代码”对应起来；
- 生产者和消费者出现问题时，优先检查 Broker 地址、Topic、序列化方式和消费者组；
- 遇到“消息重复”“消息丢失”“顺序异常”这类问题时，先回到位点提交和可靠性配置上排查；
- 入门阶段先掌握核心概念，不必一开始就追求事务消息、流式处理等高级话题。
目录
-
使用 Docker 快速部署 Kafka 学习环境，为后续实验做好准备。
-
理解 Broker、Topic、Partition、Producer、Consumer 等核心概念。
-
学习
Confluent.Kafka客户端的基础使用方法和常见操作。 -
介绍生产者发送流程、常见配置、可靠性与故障处理思路。
-
介绍消费者组、位点提交、消费行为和常见使用方式。
希望这份教程能帮助你把 Kafka 的基础概念和 .NET 实践连接起来，先跑通、再理解、最后逐步扩展到更复杂的消息系统设计场景。