从开发环境开始，记录使用 ESP-IDF 开发 ESP32 项目的过程。
本系列文章的可构建示例工程统一存放在 GitHub 仓库 Rainboylvx/esp32-learning-code 的 examples/ 目录中。文章负责讲解硬件原理、建项过程和代码思路；仓库中的工程可用于编译、烧录和对照学习。
这份路线以 ESP-IDF v5.5.5 为主线，结合《DNESP32S3 使用指南（IDF 版）》安排课程。课程顺序按知识依赖重新组织，不机械照搬教材章号；遇到教材基于 ESP-IDF v5.1.2 的旧 API 时，会单独说明迁移差异。
状态说明：
每一课都按照“读教材 → 核对原理图和引脚 → 编写 BSP 与应用 → 编译、烧录、实板验收 → 对照官方实现”的顺序完成。阶段末尾安排一个综合项目，把前面学到的模块真正组合起来。
esp32s3、实际串口和 UART；Build、Flash、Monitor 三层分别验收。compile_commands.json，并用 idf.py build 验证工程。esp_timer：用高精度软件定时器调度周期任务（教材第 14 章）esp_timer 的适用区别。vTaskDelay() 阻塞业务，多个输入事件仍能及时响应。recv() 就是一条完整消息。