3、开发环境搭建：安装Arduino IDE或PlatformIO、配置ESP32开发环境、安装必要的库（如WiFi、MQTT、传感器库）

在开始编写厨房安全监测代码之前，必须先搭建一套稳定、可复现的开发环境。ESP32 作为双核 240MHz 的微控制器，既支持 Arduino 框架的简洁高效，也支持 PlatformIO 的专业工程化管理。本章将围绕两种主流开发路径展开：Arduino IDE 适合快速原型验证和初学者上手，PlatformIO 适合多文件工程、依赖管理和持续集成。无论选择哪条路径，核心目标一致：让编译器能够正确识别 ESP32 的芯片型号、Flash 布局、分区表以及外设库，从而将烟雾传感器（如 MQ-2）、声音传感器（如 MAX9814）和 WiFi/MQTT 通信代码顺利烧录并运行。

3.1 核心原理：ESP32 开发环境的技术本质

ESP32 开发环境的核心在于工具链的匹配。ESP32 芯片内部集成两个 Xtensa LX6 处理器、WiFi/BT 射频前端、ADC/DAC 以及丰富的外设接口。Arduino 框架本质上是一套 C/C++ 的封装层，它将 ESP32 的底层寄存器操作、中断管理、定时器配置等复杂逻辑封装成统一的 pinMode()、analogRead()、digitalWrite() 等 API。而 PlatformIO 则是在此基础上增加了工程构建系统、依赖管理器和统一的命令行接口。

从编译流程来看，无论是 Arduino IDE 还是 PlatformIO，最终都会调用 xtensa-esp32-elf-gcc 交叉编译器，将用户代码编译为 ESP32 可执行的二进制文件。区别在于：Arduino IDE 将核心库、第三方库和用户代码混合编译，而 PlatformIO 通过 platformio.ini 文件显式声明板型、框架版本、库依赖和构建选项，实现更精细的控制。对于厨房安全项目这种需要同时使用 WiFi、MQTT、ADC 采样、定时器中断的复杂场景，PlatformIO 的模块化管理优势尤为明显。

3.2 操作流程：Arduino IDE 路径详细步骤

Arduino IDE 路径适合快速验证传感器读取逻辑。以下是完整的配置流程，每一步都经过实际验证，适用于 Windows/macOS/Linux 三平台。

步骤 1：安装 Arduino IDE

从 Arduino 官网下载 2.x 版本（推荐 2.3.0 以上），安装后首次启动会提示安装 USB 驱动。对于 ESP32 开发板，通常使用 CP2102 或 CH340 串口芯片，需要额外安装对应驱动。Windows 用户可在设备管理器中确认端口号（如 COM3），macOS 用户可在 /dev/cu.usbserial-* 中查看。

步骤 2：添加 ESP32 开发板管理器 URL

打开 Arduino IDE，进入 文件 → 首选项 → 附加开发板管理器网址，填入以下 URL：

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

如果网络受限，可使用镜像地址：https://espressif.github.io/arduino-esp32/package_esp32_index.json。保存后，进入 工具 → 开发板 → 开发板管理器，搜索“esp32”，安装 esp32 by Espressif Systems 核心包，版本建议选择 2.0.17（稳定版）。

步骤 3：选择开发板型号

本项目使用 ESP32 DevKitC V4 或兼容板，在 工具 → 开发板 中选择 ESP32 Dev Module。关键参数配置如下：

步骤 4：安装必要的第三方库

本项目需要以下库，通过 工具 → 管理库 搜索并安装：

• PubSubClient（作者 Nick O'Leary）— MQTT 通信，版本 2.8.0
• ArduinoJson（作者 Benoit Blanchon）— JSON 数据封装，版本 6.21.5
• DHT sensor library（作者 Adafruit）— 可选，用于温湿度补偿

WiFi 库和 ADC 库已包含在 ESP32 核心包中，无需单独安装。安装完成后，在 文件 → 示例 中应能看到 ESP32 → WiFi → WiFiScan 示例，编译上传后串口监视器应输出附近 WiFi 列表，这表示环境配置成功。

3.3 操作流程：PlatformIO 路径详细步骤

PlatformIO 更适合工程化开发，尤其当项目包含多个源文件、自定义库和自动化测试时。以下是基于 VS Code 的完整配置流程。

步骤 1：安装 VS Code 与 PlatformIO 插件

安装 VS Code 后，在扩展市场搜索 PlatformIO IDE，点击安装。安装完成后，左侧会出现 PlatformIO 图标。首次启动会下载平台工具链，耗时约 5-10 分钟，请保持网络畅通。

步骤 2：创建工程并选择板型

点击 PlatformIO 主页的 New Project，输入项目名称（如 kitchen_safety），在 Board 栏搜索 esp32dev，选择 Espressif ESP32 Dev Module。Framework 选择 Arduino。PlatformIO 会自动生成工程结构：

kitchen_safety/
├── include/          # 用户头文件
├── lib/              # 私有库
├── src/              # 主源码
│   └── main.cpp
├── test/             # 单元测试
├── platformio.ini    # 核心配置文件
└── .vscode/          # 编辑器配置

步骤 3：配置 platformio.ini

这是 PlatformIO 的核心配置文件，直接决定编译和烧录行为。以下为本项目的推荐配置：

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
lib_deps = 
    knolleary/PubSubClient@^2.8
    bblanchon/ArduinoJson@^6.21
    adafruit/DHT sensor library@^1.4.4
build_flags = 
    -DCORE_DEBUG_LEVEL=3
    -DMQTT_MAX_PACKET_SIZE=512

其中 lib_deps 会自动从 PlatformIO 库管理器下载指定版本，build_flags 中的 MQTT_MAX_PACKET_SIZE 用于增大 MQTT 缓冲区，避免 JSON 数据过长导致丢包。

步骤 4：编译与烧录

点击底部状态栏的 ✓ 图标进行编译，→ 图标进行烧录。PlatformIO 会自动识别串口端口。若烧录失败，检查 platformio.ini 中的 upload_port 是否指定正确，或尝试降低 upload_speed 至 115200。

3.4 案例拆解：从零搭建厨房安全监测开发环境

下面通过一个完整案例，展示从环境搭建到传感器数据读取的全过程。该案例模拟实际厨房场景：使用 MQ-2 烟雾传感器检测燃气泄漏，使用 MAX9814 声音传感器检测异常响动。

背景与目标

某智能家居团队需要快速验证 ESP32 读取两个模拟传感器的可行性。硬件连接如下：MQ-2 的 AO 引脚接 GPIO34（ADC1_CH6），MAX9814 的 OUT 引脚接 GPIO35（ADC1_CH7），两者共用 3.3V 和 GND。目标是在串口监视器以 1Hz 频率输出烟雾浓度和声音强度值。

初始现象与问题

使用 Arduino IDE 默认配置编译上传后，串口输出全为 0 或乱码。通过排查发现两个问题：一是 MQ-2 传感器需要预热 3-5 分钟，初始读数接近 0 属正常；二是串口监视器波特率与代码中 Serial.begin() 不一致，导致乱码。

分析判断过程

首先检查硬件连接，用万用表测量 MQ-2 的 VCC 引脚电压为 3.28V，正常。然后检查代码，发现 analogRead() 的引脚号错误——ESP32 的 ADC 引脚编号与 GPIO 编号不同，GPIO34 对应 ADC1_CH6，但代码中误写为 analogRead(34)，实际应使用 analogRead(34) 是可行的，但更规范的做法是使用 analogRead(ADC1_CH6) 或直接使用 GPIO 编号。最终确认问题出在串口波特率：代码中设置为 115200，而串口监视器默认 9600。

实际操作步骤

// 修正后的传感器读取代码
#define SMOKE_PIN 34   // GPIO34, ADC1_CH6
#define SOUND_PIN 35   // GPIO35, ADC1_CH7

void setup() {
  Serial.begin(115200);
  analogReadResolution(12);  // 12位分辨率，0-4095
  analogSetAttenuation(ADC_11db);  // 衰减11dB，量程约3.3V
}

void loop() {
  int smoke_raw = analogRead(SMOKE_PIN);
  int sound_raw = analogRead(SOUND_PIN);
  float smoke_voltage = smoke_raw * (3.3 / 4095.0);
  float sound_voltage = sound_raw * (3.3 / 4095.0);
  
  Serial.printf("Smoke: %d (%.2fV) | Sound: %d (%.2fV)\n", 
                smoke_raw, smoke_voltage, sound_raw, sound_voltage);
  delay(1000);
}

将串口监视器波特率调整为 115200 后，输出正常。预热 5 分钟后，烟雾传感器读数稳定在 200-300 之间（对应 0.16-0.24V），声音传感器在安静环境下读数约 50-80，拍手时跳变至 2000 以上。

结果对比与复盘

复盘发现，ESP32 的 ADC 在 3.3V 供电下存在非线性，建议在代码中做软件校准。此外，MQ-2 的模拟输出与气体浓度呈指数关系，后续需要查表或拟合曲线进行标定。

3.5 常见误区与总结复盘

以下是开发环境搭建中常见的五个问题及解决方案：

1. 烧录失败（A fatal error occurred: Failed to connect to ESP32）：按住开发板上的 BOOT 键不放，点击烧录，待出现 Connecting 提示后松开。若仍失败，检查串口驱动和线缆质量。
2. 编译报错找不到 WiFi.h：确认已安装 ESP32 核心包，且选择的开发板型号正确。在 PlatformIO 中检查 platformio.ini 的 framework 是否为 arduino。
3. 串口输出乱码：统一代码中的 Serial.begin() 波特率与串口监视器设置。推荐使用 115200。
4. ADC 读数不准确：使用 analogSetAttenuation(ADC_11db) 扩展量程，并在代码中做多点校准。
5. MQTT 连接失败：检查 PubSubClient 库的缓冲区大小，默认 256 字节可能不够，通过 MQTT_MAX_PACKET_SIZE 宏增大。

总结而言，开发环境搭建是厨房安全项目的基础工程。Arduino IDE 适合快速原型验证，PlatformIO 适合正式工程开发。无论选择哪种方式，都需要确保 ESP32 核心库版本、第三方库版本和编译选项三者匹配。建议在项目初期就建立版本管理（Git），将 platformio.ini 或 Arduino 的 sketch.yaml 纳入版本控制，确保团队协作时环境一致。下一阶段将进入传感器驱动开发，届时需要结合本章搭建的环境进行实际编码和调试。