1. ESP32开发环境搭建：Arduino IDE与ESP-IDF双平台配置

做嵌入式开发这么多年，我始终觉得环境搭建是入门的第一道坎。ESP32这块芯片，官方给了两套开发工具——Arduino IDE和ESP-IDF。说白了，一个适合快速验证，一个适合深度开发。我个人习惯是两套都装，根据项目阶段切换着用。

今天咱们就把这两套环境都跑通，最后让板子上的LED闪起来。嗯，这是嵌入式界的"Hello World"。

1.1 认识ESP32开发板

先看看咱们要用的硬件。ESP32是乐鑫科技推出的双核Wi-Fi+蓝牙芯片，主频最高240MHz，内置520KB SRAM。市面上常见的开发板长这样：

1.2 方案一：Arduino IDE 快速上手

Arduino IDE适合快速验证想法。我刚开始学ESP32时就用它，5分钟就能让LED闪起来。

1.2.1 安装步骤

1. 下载Arduino IDE：去官网arduino.cc，下载1.8.19版本（2.0以上也行，但有些库还不稳定）
2. 安装USB转串口驱动：CP2102或CH340，看你的开发板用哪个芯片
3. 配置ESP32开发板支持：
   • 打开Arduino IDE → 文件 → 首选项
   • 在"附加开发板管理器网址"填入：https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
   • 工具 → 开发板 → 开发板管理器 → 搜索"ESP32" → 安装
4. 选择开发板：工具 → 开发板 → ESP32 Arduino → ESP32 Dev Module

1.2.2 第一个点灯程序

ESP32开发板上通常有两个LED：一个是电源指示灯（红色），另一个是GPIO2连接的蓝色LED。咱们就用这个蓝色LED做实验。

// ESP32 点灯程序 - Arduino IDE版本
// 板载LED通常接在GPIO2，低电平点亮

#define LED_BUILTIN 2

void setup() {
  Serial.begin(115200);
  pinMode(LED_BUILTIN, OUTPUT);
  Serial.println("ESP32 点灯程序启动！");
}

void loop() {
  digitalWrite(LED_BUILTIN, LOW);   // 点亮LED
  delay(500);                       // 保持500ms
  digitalWrite(LED_BUILTIN, HIGH);  // 熄灭LED
  delay(500);                       // 保持500ms
}

上传步骤：工具 → 端口 → 选择你的COM口 → 点击上传按钮。看到"Connecting..."时，按住开发板上的BOOT键不放，直到上传进度条开始走动再松手。

1.3 方案二：ESP-IDF 专业开发环境

Arduino IDE虽然方便，但做复杂项目时你会发现它不够灵活。ESP-IDF是乐鑫官方提供的专业框架，支持FreeRTOS、组件管理、内存分析等高级功能。咱们课程后面讲任务调度时，主要用ESP-IDF。

1.3.1 安装ESP-IDF

我推荐用VS Code + ESP-IDF插件的方式，图形化操作，省心。

1. 安装VS Code：code.visualstudio.com
2. 安装ESP-IDF插件：在扩展市场搜索"ESP-IDF"，安装由Espressif Systems发布的那个
3. 配置工具链：
   • 按F1打开命令面板，输入"ESP-IDF: Configure ESP-IDF extension"
   • 选择"ADVANCED"模式
   • 选择ESP-IDF版本（建议选v5.1或v5.2）
   • 等待自动下载工具链、编译器、OpenOCD等

1.3.2 创建第一个ESP-IDF项目

ESP-IDF的项目结构跟Arduino不太一样。每个项目都是一个独立的文件夹，包含CMakeLists.txt和main目录。

my_blink/
├── CMakeLists.txt          # 项目级构建配置
├── main/
│   ├── CMakeLists.txt      # 组件级构建配置
│   └── blink.c             # 主程序文件
└── sdkconfig               # 配置项（自动生成）

用VS Code创建项目：F1 → "ESP-IDF: Show Examples Projects" → 选择"get-started/hello_world" → 复制到工作目录。然后修改main目录下的c文件：

// ESP32 点灯程序 - ESP-IDF版本
// 使用FreeRTOS的延时函数

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"

#define BLINK_GPIO GPIO_NUM_2

void app_main(void)
{
    gpio_reset_pin(BLINK_GPIO);
    gpio_set_direction(BLINK_GPIO, GPIO_MODE_OUTPUT);

    printf("ESP32 IDF 点灯程序启动！\n");

    while (1) {
        gpio_set_level(BLINK_GPIO, 0);  // 点亮
        vTaskDelay(500 / portTICK_PERIOD_MS);
        gpio_set_level(BLINK_GPIO, 1);  // 熄灭
        vTaskDelay(500 / portTICK_PERIOD_MS);
    }
}

编译和烧录：点击VS Code底部状态栏的"ESP-IDF Build, Flash and Monitor"按钮。或者用命令行：

idf.py build
idf.py -p COM3 flash monitor

1.4 双平台对比：什么时候用哪个？

1.5 知识体系总览

下面这张图把本章的核心内容串起来了。你想想看，从硬件选型到双平台搭建，再到第一个点灯程序，其实就这三步：

1.6 常见问题与避坑指南

• 上传失败，提示"A fatal error occurred: Failed to connect to ESP32"：按住BOOT键再试，或者检查串口驱动是否安装正确
• LED不亮：先确认GPIO2是否被其他外设占用。有些开发板的GPIO2接了其他器件，需要换一个引脚
• Arduino IDE编译报错"ESP32 core not found"：重新检查开发板管理器中的安装状态，或者手动删除C:\Users\用户名\AppData\Local\Arduino15下的esp32文件夹后重装
• ESP-IDF编译慢：第一次编译要下载工具链，确实慢。后面增量编译就快了。我一般用idf.py build -j4开启多核编译