3. 开发环境搭建：ESP-IDF与Arduino IDE双平台配置，SDK下载与编译
好，咱们直接进入正题。
做扫地机器人的WiFi和蓝牙通信，选对开发环境是第一步。我个人习惯是双平台都备着——ESP-IDF做底层驱动和协议栈调优，Arduino IDE做快速原型验证。你想想看，一个项目里，两种场景都有用武之地。
3.1 为什么需要双平台？
说白了，ESP-IDF是乐鑫官方推荐的框架，功能全、性能强，但学习曲线陡一点。Arduino IDE呢，上手快，社区资源多，适合快速验证想法。
我在项目中遇到过这样的情况：用Arduino搭好WiFi配网和蓝牙扫描的原型，只花了两小时。但真要优化功耗和内存，还得回到ESP-IDF里调FreeRTOS任务优先级和内存池。所以，两个都得会。
核心思路：
- ESP-IDF：用于正式产品开发，支持完整的WiFi/BLE协议栈，内存管理更精细。
- Arduino IDE：用于快速原型验证，适合教学和初期调试。
3.2 ESP-IDF环境搭建
嗯，这里要注意，ESP-IDF的安装方式在不同操作系统上略有差异。我以Windows为例，Linux和macOS类似，只是命令行工具不同。
3.2.1 安装依赖工具
先装Python 3.8以上版本，还有Git。这两个是基础，没有它们，后面寸步难行。
- Python：从官网下载，安装时记得勾选“Add Python to PATH”。
- Git：同样从官网下载，安装时选择“Use Git from the Windows Command Prompt”。
3.2.2 下载ESP-IDF SDK
打开命令行，找个干净的目录，执行：
git clone --recursive https://github.com/espressif/esp-idf.git这里有个坑——--recursive参数不能少。它会把子模块一起拉下来。我曾经因为忘记加这个参数，编译时疯狂报错，找了半天才发现是子模块缺失。
3.2.3 安装工具链
进入ESP-IDF目录，运行安装脚本：
cd esp-idf
install.bat这个脚本会自动下载交叉编译工具链、OpenOCD调试器、以及必要的Python包。整个过程大概5-10分钟，取决于你的网速。
3.2.4 设置环境变量
每次打开新终端，都需要运行：
export.bat或者，我建议你把它加到系统环境变量里，省得每次都要手动执行。具体做法是：在系统变量里添加IDF_PATH指向ESP-IDF目录，再把%IDF_PATH%\tools加到PATH里。
小技巧： 如果你用VS Code，可以安装“ESP-IDF Extension”插件。它会自动帮你配置环境，还能一键编译、烧录、监视串口。省心不少。
3.3 Arduino IDE环境搭建
Arduino IDE就简单多了。说白了，就是个集成好的编辑器加编译器。
3.3.1 安装Arduino IDE
从官网下载最新版，直接安装。目前我用的是2.x版本，界面比1.x好看，功能也强一些。
3.3.2 添加ESP32开发板支持
打开Arduino IDE，进入“文件” -> “首选项”，在“附加开发板管理器网址”里填入：
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json然后，打开“工具” -> “开发板” -> “开发板管理器”，搜索“ESP32”，点击安装。这个包大概200MB，包含所有ESP32系列的板级支持包（BSP）。
3.3.3 选择开发板
安装完成后，在“工具” -> “开发板”里选择你的板子。我常用的是“ESP32 Dev Module”，它兼容大多数ESP32开发板。
注意： 如果你用的是ESP32-S3或C3系列，记得选对应的板型。选错了，编译能过，但烧录后可能跑不起来。我吃过这个亏，当时还以为是硬件坏了。
3.4 SDK下载与编译实战
环境搭好了，咱们来编译个例子试试手。
3.4.1 ESP-IDF示例编译
以WiFi扫描为例，这是最基础的WiFi功能，扫地机器人配网时就用它。
cd esp-idf/examples/wifi/scan
idf.py set-target esp32
idf.py menuconfig
idf.py buildmenuconfig这一步，你可以配置WiFi的SSID、密码、以及一些协议栈参数。比如，我习惯把WiFi的TX功率调低一点，省电。
编译成功后，烧录：
idf.py -p COM3 flash monitor这里的COM3是你的串口号，Windows下可以在设备管理器里查。macOS/Linux下一般是/dev/ttyUSB0或/dev/ttyACM0。
3.4.2 Arduino IDE示例编译
打开Arduino IDE，选择“文件” -> “示例” -> “ESP32 WiFi” -> “WiFiScan”。直接点上传按钮。就这么简单。
你会在串口监视器里看到扫描到的WiFi列表。嗯，这个例子用来验证硬件和驱动是否正常，非常方便。
对比总结：
| 特性 | ESP-IDF | Arduino IDE |
|---|---|---|
| 编译速度 | 较慢（完整工具链） | 较快（预编译库） |
| 内存控制 | 精细（可调FreeRTOS堆栈） | 粗放（默认配置） |
| 协议栈支持 | 完整（WiFi/BLE/ESP-NOW） | 基础（常用功能） |
| 适合场景 | 产品开发、性能优化 | 原型验证、教学 |
3.5 常见问题与避坑指南
环境搭建过程中，有几个坑我几乎每次都会遇到，分享给你。
- Python版本不匹配：ESP-IDF 4.4及以上版本要求Python 3.8+。如果你装了Python 3.7，编译时会报语法错误。我建议用Python 3.10，兼容性最好。
- Git子模块下载失败：国内网络有时连不上GitHub。可以试试用代理，或者换成国内镜像源。比如，在克隆时加上
-c http.proxy=http://127.0.0.1:7890。 - 串口驱动问题：ESP32开发板通常用CH340或CP2102芯片。如果电脑识别不到串口，去装对应的驱动。我曾经在Win11上折腾了一下午，最后发现是驱动签名问题。
我的习惯： 每次搭建新环境，我都会先编译一个最简单的“Hello World”示例（ESP-IDF里叫hello_world，Arduino里叫Blink）。如果这个能跑通，说明工具链和硬件都没问题。然后再去搞WiFi和蓝牙。
3.6 小结
好了，环境搭建就讲到这里。你手头有ESP32开发板的话，现在就可以动手试试。先装ESP-IDF，再装Arduino IDE，各编译一个示例。相信我，跑通第一个例程的那一刻，你会觉得前面所有的折腾都值了。
下一章，咱们开始写真正的WiFi配网代码。到时候，你会看到这两个环境各自的优势到底在哪里。