1.1 认识 ESP32 与 ESP-IDF
ESP32 系列是乐鑫科技推出的一款低功耗、高性能的物联网 SoC 芯片，包括 2.4 GHz Wi-Fi、
蓝牙是它独特的优势。它采用 40 nm 工艺，在功耗、射频、安全性和可靠性方面都很出色，适合开发各种物联网应用。
ESP-IDF 全称 Espressif IoT Development Framework，是乐鑫提供的官方软件开发框架，基本包含了
ESP32 使用的全部 API 和运行工具链的脚本，可协助开发者快速开发 Wi-Fi、蓝牙、
低功耗等物联网应用。ESP-IDF 现在官方推荐使用 安装管理器（EIM） 来安装，支持 Windows 和 Linux 。
💡 提示： 如果你更习惯图形化开发，也可以选择 Arduino-ESP32 核心。做进阶开发、追求性能和寄存器级的掌控
建议以 ESP-IDF 为主。主播是用 ESP-IDF V5.5.5 。
1.2 准备工作
硬件准备
- 一块 ESP32 开发板。我用的是自己绘制并焊接的帅帅子专用ESP32P4C6
- USB 数据线 type-C
- 一台电脑（Windows或者Linux），我使用的是 windows 远程访问 Linux 的形式
软件准备
- 编辑器：VS Code（下载安装时注意）
- 构建工具：CMake 和 Ninja，用于编译 ESP32 应用程序
- ESP-IDF 框架：包含 API、源代码和脚本
⚠️ 注意： 请务必使用合适的数据线连接开发板——有些线只支持充电不支持数据传输，会导致烧录失败。
1.3 环境安装（分平台）
ESP-IDF 官方推荐使用 ESP-IDF 安装管理器（EIM） 来安装开发环境，它支持 GUI（图形界面）和 CLI（命令行）两种方式。GUI 适合大多数用户，CLI 适合自动化/CI 场景。下面按平台说明。
Windows
- 下载并运行 ESP-IDF 安装管理器（EIM）GUI，按向导勾选所需组件完成安装。
- 安装完成后，可在 Espressif-IDE（基于 Eclipse CDT）或 Visual Studio Code + ESP-IDF 扩展 中进行图形化开发。
Linux / macOS
- 官方推荐使用 ESP-IDF 安装管理器（EIM CLI） 一键安装工具链、构建工具和框架，适合自动化与脚本化部署。
- 也可以选择 手动安装：先安装依赖（如 git、python3、cmake、ninja 等），再通过
git clone 获取 ESP-IDF。手动安装步骤较多，建议优先使用 EIM 或官方安装脚本，避免踩坑。
🔗
官方参考： 完整的分平台安装指南见乐鑫官方文档
ESP-IDF 快速入门
（Windows / Linux / macOS 均有详细的分步说明），安装有疑问时以官方文档为准。
1.4 构建首个项目
安装好 ESP-IDF 后，可以通过 命令行 或 IDE 来创建、编译并烧录第一个项目。
命令行方式
- 进入 ESP-IDF 环境（Windows 使用 IDF 命令提示符；Linux/macOS 先执行
export.sh 脚本激活环境）。
- 复制官方示例项目：
cp -r $IDF_PATH/examples/get-started/hello_world .
- 进入项目目录，打开配置菜单：
idf.py menuconfig
- 编译：
idf.py build
- 烧录到开发板：
idf.py -p /dev/ttyUSB0 flash（Windows 端口类似 COM3）
- 监视串口输出：
idf.py monitor
🖥️ 提示： 如果使用 VS Code + ESP-IDF 扩展 或 Espressif-IDE，可在图形界面里直接点击「Build / Flash / Monitor」按钮完成这三步，更直观。
1.5 常见问题与建议
- 识别不到串口： 确认 USB 线支持数据传输、正确安装 CP210x/CH340 等 USB 转串口驱动。
- 编译失败： 多为环境变量或依赖问题，建议使用 EIM 或官方脚本安装，保持 Python 与 CMake 版本兼容。
- 烧录失败： 按住开发板
BOOT 键再复位，或检查端口权限（Linux 下将当前用户加入 dialout 组）。
- 开发建议： 先跑通
hello_world 示例，再逐步学习 GPIO、Wi-Fi、定时器等模块；多参考官方 examples 目录。
✅ 本节完： 搭建好环境、跑通第一个点灯/串口工程后，就可以进入下一章学习 GPIO 与 LED 控制啦。持续更新中…