# ESP32从初见到入门（ESP32-Guide）
## 许可协议：
本仓库中的文本、代码、图片和视频均采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议— [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)。只要保持原作者署名和非商用，您可以自由地阅读、分享、修改分发本教程的文章和代码。
## 在线阅读：
- [github-pages](https://duruofu.github.io/ESP32-Guide)
- [DuRuofu的个人博客](https://blog.duruofu.top/docs/03.Embedded/ESP32/2025-ESP32-Guide/README.html)
此外，文档配有对应的视频教程，可前往[B站（点击跳转）](https://www.bilibili.com/video/BV1fi6qY5EAC/?vd_source=ef5a0ab0106372751602034cdd9ab98e)浏览。
## 前言：
本教程基于**ESP-IDF-V5.3.2**，旨在记录并分享个人学习ESP32过程中的经验和心得，以帮助其他初学者快速上手ESP32开发。这是一份从初学者视角出发，整理了学习ESP32的一条较为合理的路径和方法的笔记汇编。
文档内容基于对大量优质ESP32教程、官方文档以及实际项目实践的总结和理解，力求做到内容清晰、条理分明，既注重基础知识的巩固，也兼顾实战技能的提升。希望通过本教程，读者能少走弯路，从初学到实战开发，逐步掌握ESP32的开发技能。
文档内容从基础到进阶，适合循序渐进地学习。如果您是初学者，可以按照章节顺序逐步学习；如果您已有一定的开发经验，可以直接跳转到感兴趣的部分阅读。同时，鼓励读者在学习过程中动手实践，以便更好地理解相关知识点。
### 初衷：
1. 一方面，本人在从零开始学习ESP32的过程中曾经走过很多弯路，踩过很多坑，现在回过头来觉得有更适合初学者学习的路径，故推荐给大家，希望后来人不要走了弯路。
2. 另一方面，我始终认为，学习嵌入式，学习ESP32的秘诀是以实践促学习，也就是我们常说的费曼学习法—以输出倒逼输入。不要想着等我学会ESP32我就可以做什么，不妨换个思路，想想我现在需要做什么，做的这个东西需要用到ESP32的什么功能，然后点对点的去学习某个部分，这样学习完后可以立马投入使用，加深记忆。这份教程本身也算是我个人践行费曼学习法的实践过程。
### 目录：
本教程共八个章节，三个阶段：基础（1-3），实践（4），进阶（5-10）
其中基础章节一定要确保自己掌握，实践和进阶部分推荐按照个人需求进行选学。
点击此处查看详细目录：[详细目录](./docs/docs/guide/目录.md)
### 相关硬件及开发板：
学习ESP32离不开一块趁手的开发板，笔者认为初学者学习ESP32的重点不在于一块全能的开发板，重点在于立刻开始学习，很多复杂的外设在初学时是用不到的。所以上手阶段推荐使用市面上常见的ESP32最小系统板，价格一般在20元左右，足够学习本教程除LVGL，特殊外设，实战演练以外的部分。
此外，由于WiFi，蓝牙章节涉及到板间通信，需要使用两块开发板，所以推荐读者准备两块ESP32最小系统板。
遵循以上原则，本教程大部分章节均使用下图所示的开发板，主控型号为ESP32-WROOM-32
如果想进一步节省学习成本，还可以使用这种15.9元的ESP32-C3开发板（淘宝搜下面的图，建议买焊接排针的经典款）：
至于LVGL，特殊外设，实战演练部分，会在教程章节单独推荐开发板或外设模块。
## 参考链接
- 孤独的二进制： https://space.bilibili.com/1375767826
- Augtons正(单片机)： https://blog.csdn.net/m0_50064262/article/details/120250151
- 乐鑫文档： https://docs.espressif.com/projects/esp-idf/zh_CN/release-v4.4/esp32c3/index.html
- 第九个下弦月： https://space.bilibili.com/34165842?spm_id_from=333.999.0.0
- Michael_ee： https://space.bilibili.com/505630520/fans/follow?tagid=529812