前言

ESP32作為一款功能強大的物聯網開發芯片，結合PlatformIO這一現代化嵌入式開發平臺，可以大幅提升開發效率。本文將詳細介紹如何在VSCode中搭建ESP32開發環境，并分享實用開發技巧。

---

一、環境安裝（Windows/macOS/Linux）

1.1 安裝必備工具

1. 安裝 VSCode

   • 官網下載: code.visualstudio.com

2. 安裝 PlatformIO 插件

   • 在 VSCode 擴展商店搜索 "PlatformIO IDE"

   • 或通過命令行安裝：

     pio home

3. 驗證安裝

   pio --version ?# 應顯示 ≥6.1.0
   pio platform list ?# 查看支持的平臺

1.2 驅動安裝（Windows用戶特別注意）

1. ESP32 USB驅動：

   • CP210x驅動：Silicon Labs官網

   • CH340驅動：WCH官網

---

二、創建第一個項目

1. 新建項目

   • 快捷鍵 Ctrl+Shift+P → 輸入 PlatformIO: New Project，或點擊底部狀態欄的小房子圖標，如下圖所示

   • 配置參數示例：

     Name: esp32_demo # 項目名稱
     Board: Espressif ESP32 Dev Module # 選擇你對應的開發板
     Framework: ESP-IDF  # 或 Arduino
     Location: 自定義路徑

2. 項目結構解析

   .
   ├── include/ ? ? ? ?  # 頭文件
   ├── lib/ ? ? ? ? ? ?  # 第三方庫
   ├── src/ ? ? ? ? ? ?  # 主代碼
   │ ? └── main.c ? ? ?  # 或 main.cpp
   ├── test/ ? ? ? ? ? ? # 單元測試
   └── platformio.ini ?  # 核心配置文件

---

三、platformio.ini 配置

[env:esp32dev]
platform = espressif32
board = esp32dev ? ? ?  # 開發板型號
framework = espidf ? ?  # 或 arduino
monitor_speed = 115200  # 串口波特率
?
upload_port = COM3 ? ? # 指定串口
upload_speed = 921600  # 高速燒錄

PlatformIO.ini配置語法見: ?PlatformIO.ini 語法入門指南

完整配置參考：PlatformIO官方文檔

---

四、核心工作流

1. 代碼編譯

pio run ?# 或點擊底部狀態欄的 √ 圖標

2. 燒錄固件

pio run --target upload ?# 或點擊 → 圖標

3. 串口監控

pio device monitor ?# 或點擊插頭圖標
# 快捷鍵:
# Ctrl+T → Ctrl+X 退出
# Ctrl+T → Ctrl+L 清屏

4. 清理項目

pio run --target clean

---

五、ESP32 開發技巧

1. 雙核任務創建示例

#include <freertos/FreeRTOS.h>
#include <freertos/task.h>
?
void core0_task(void *pv) {while(1) {vTaskDelay(1000 / portTICK_PERIOD_MS);printf("Core 0 running\n");}
}
?
void app_main() {xTaskCreatePinnedToCore(core0_task, "core0", 4096, NULL, 1, NULL, 0);
}

2. 使用 Arduino 庫（在 ESP-IDF 框架下）

; platformio.ini 添加
build_flags = -DUSE_ARDUINO_LIBRARIES
lib_deps = adafruit/Adafruit SSD1306@^2.5.7

---

六、調試配置

1. 硬件調試（需 JTAG 調試器）

   [env:debug]
   platform = espressif32
   board = esp32dev
   debug_tool = jlink  # 或 olimex-arm-usb-tiny-h
   build_type = debug

2. 啟動調試會話

   • 點擊 VSCode 左側調試圖標

   • 選擇 PlatformIO Debug 配置

---

七、高級功能

1. 單元測試

pio test -e esp32dev ?# 運行測試
pio test --verbose ? ?# 詳細輸出

2. 自定義開發板配置

1. 在 boards/ 目錄創建 custom_esp32.json

2. 定義板載資源：

   {"build": {"mcu": "esp32","flash_size": "16MB","partitions": "custom_partitions.csv"}
   }

3. 多環境配置

[env:release]
build_flags = -DNDEBUG -Os
?
[env:debug]
build_flags = -g3 -O0

---

八、學習資源

1. 官方文檔: docs.platformio.org

2. ESP32 專用配置指南: ESP32 PlatformIO Docs

3. 示例項目庫:

   pio lib search "esp32 ble"
   pio project init --ide vscode --board esp32dev

通過本文章，您可以掌握 PlatformIO 開發 ESP32 的入門技能。如果你對物聯網、智能家居、無線傳感器感興趣,歡迎點贊收藏，此后會持續更新相關內容。