3. ESP-IDF开发环境搭建：ESP-IDF安装、VS Code配置、Hello World程序、编译与烧录
好，咱们正式开始动手了。
这一章，我带你把ESP-IDF的开发环境搭起来。说实话，很多初学者卡在这一步就放弃了——不是ESP-IDF难，而是环境配置的坑太多。我当年第一次装ESP-IDF时，光Python版本冲突就折腾了一下午。嗯，后来我学乖了，总结了一套稳如老狗的流程。
你跟着我走，半小时内，保证让你看到Hello World打印出来。
3.1 ESP-IDF是什么？
ESP-IDF，全称Espressif IoT Development Framework，是乐鑫官方为ESP32系列芯片提供的软件开发框架。说白了，它就是一套帮你操作ESP32的“工具包+库函数”。
你写代码时，不需要直接操作寄存器（当然你想也行），而是调用IDF提供的API。比如初始化Wi-Fi、创建TCP连接、读写Flash，都有现成的函数。
我个人习惯把ESP-IDF理解为“ESP32的Linux内核”——它提供了FreeRTOS实时操作系统、各种驱动、网络协议栈，甚至还有OTA升级框架。你想想看，一个单片机框架能做到这个程度，确实很良心。
3.2 安装ESP-IDF
安装方式有两种：一种是官方的一键安装工具（Windows下叫ESP-IDF Tools Installer），另一种是手动从GitHub拉取源码。我推荐新手用第一种，省心。
3.2.1 Windows环境安装
- 去乐鑫官网下载 ESP-IDF Tools Installer（选择离线版，大概1.2GB）。
- 双击运行，一路Next。注意安装路径不要有中文和空格，比如
C:\esp\esp-idf。 - 安装过程中会自动下载Python、Git、交叉编译工具链。你只需要等着就行。
- 安装完成后，桌面会出现一个 ESP-IDF 5.x CMD 的快捷方式。双击打开，这就是你的开发终端。
idf.py --version，如果能看到版本号，说明安装成功。我曾经遇到一个学员，装完后没重启电脑，结果环境变量没生效，折腾了半天。
3.2.2 Linux/Mac环境安装
Linux下更简单，一条命令搞定：
git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
./install.sh all
. ./export.sh注意最后一步 . ./export.sh，前面有个点，这是source命令的简写。它的作用是把IDF的环境变量加载到当前终端。每次打开新终端，你都得执行一次这个命令。嫌麻烦？可以把它加到 ~/.bashrc 里。
3.3 VS Code配置
终端编译虽然酷，但写代码还是得靠IDE。VS Code + ESP-IDF插件，是目前最舒服的组合。
3.3.1 安装VS Code
去code.visualstudio.com下载安装，这个不用我教吧？装完后，记得安装中文语言包（如果你看英文界面头疼）。
3.3.2 安装ESP-IDF插件
- 打开VS Code，点击左侧扩展图标（或者按Ctrl+Shift+X）。
- 搜索 ESP-IDF，找到乐鑫官方出的那个（图标是绿色的ESP32芯片）。
- 点击安装。安装完成后，VS Code右下角会弹出一个配置向导。
- 点击“Configure ESP-IDF”，选择你刚才安装的ESP-IDF路径（比如
C:\esp\esp-idf）。 - 插件会自动检测Python、工具链等。等它跑完，你就拥有了一个完整的ESP32开发环境。
Ctrl+Shift+P，输入 ESP-IDF: Show Examples Projects，可以直接浏览官方示例。这个功能很实用，我经常用它来快速验证某个外设的用法。
3.4 Hello World程序
环境搭好了，咱们来写第一个程序。别紧张，就几行代码。
3.4.1 创建项目
打开终端（或者VS Code的终端），执行：
idf.py create-project hello_world
cd hello_world这个命令会在当前目录下生成一个 hello_world 文件夹，里面包含 main 子目录和 CMakeLists.txt 文件。
3.4.2 编写代码
打开 main/hello_world_main.c，把内容替换成：
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_system.h"
#include "esp_spi_flash.h"
void app_main(void)
{
printf("Hello World! 这是ESP32 Mesh课程的第一个程序\n");
printf("芯片型号: %s\n", CONFIG_IDF_TARGET);
printf("Flash大小: %d MB\n", spi_flash_get_chip_size() / (1024 * 1024));
// 延时2秒后重启，模拟一个循环
vTaskDelay(2000 / portTICK_PERIOD_MS);
esp_restart();
}代码很简单：打印信息，然后重启。你想想看，这其实就是嵌入式世界的“Hello World”——证明你的CPU在跑，你的串口能输出。
3.4.3 配置项目
在项目根目录下执行：
idf.py set-target esp32这个命令会下载ESP32的芯片配置。如果你用的是ESP32-S3或C3，把 esp32 换成对应的型号就行。
然后运行：
idf.py menuconfig你会看到一个图形化的配置界面。这里可以调整Wi-Fi参数、Flash大小、日志等级等。对于Hello World，我们什么都不用改，直接按 Q 退出，选 Yes 保存。
menuconfig 是ESP-IDF的核心配置工具。你以后做Mesh网络时，很多参数（比如Mesh最大节点数、路由表大小）都要在这里改。建议你花10分钟把每个菜单都点开看看。
3.5 编译与烧录
代码写好了，配置也调完了，接下来就是见证奇迹的时刻。
3.5.1 编译
在项目根目录下执行：
idf.py build编译过程大概1-3分钟，取决于你的电脑性能。你会看到终端里刷刷刷地跑过一堆编译信息。如果最后出现 Project build complete，恭喜你，编译成功了。
如果报错，别慌。90%的错误都是路径问题或Python版本问题。检查一下你的环境变量，或者重新执行 export.sh（Linux/Mac）或打开 ESP-IDF CMD（Windows）。
找不到Python模块，我查了半天，发现是Windows系统里装了多个Python版本，IDF调用了错误的那个。解决方案：在 ESP-IDF CMD 里执行 where python，确认用的是IDF自带的Python。
3.5.2 烧录
把ESP32开发板用USB线连接到电脑。在终端里执行：
idf.py -p COM3 flash注意把 COM3 换成你实际的串口号。Windows下可以在设备管理器里查看，Linux下一般是 /dev/ttyUSB0 或 /dev/ttyACM0。
烧录过程中，你会看到 Connecting... 的提示。如果卡在这里不动，通常是因为ESP32没有进入下载模式。解决办法：按住开发板上的 BOOT 键，再按一下 EN 键（复位），然后松开 BOOT 键。嗯，这个操作我刚开始时也经常忘。
3.5.3 查看输出
烧录完成后，执行：
idf.py -p COM3 monitor这个命令会打开串口监视器。你会看到ESP32重启，然后打印出：
Hello World! 这是ESP32 Mesh课程的第一个程序
芯片型号: esp32
Flash大小: 2 MB然后每隔2秒重启一次，循环打印。按 Ctrl+] 可以退出监视器。
monitor 模式下，你可以直接按 Ctrl+T 然后按 H 查看帮助。比如按 Ctrl+T 再按 R 可以复位芯片，不用重新插拔USB线。这个小技巧能省你不少时间。
3.6 本章小结
到这里，你的ESP-IDF开发环境就彻底搭好了。你学会了：
- 安装ESP-IDF并配置环境变量
- 在VS Code中集成ESP-IDF插件
- 创建、编译、烧录一个Hello World程序
- 使用串口监视器查看输出
下一章，咱们开始真正进入Mesh网络的世界。我会带你分析ESP-Mesh-Lite的协议栈架构，看看数据包在节点之间是怎么跳转的。做好准备，好戏要开场了。
esp_efuse_mac_get_default() 函数）。这是你第一次接触ESP32的硬件API，试试看。