目录

ESP-IDF

ESP-IDF (Espressif IoT Development Framework) 是乐鑫科技提供的官方物联网开发框架,适用于 ESP32、ESP32-S 和 ESP32-C 系列 SoC。

相关文档:ESP-IDF 官方文档

VSCode

官方提供了 VSCode 的扩展插件,可使用 VSCode 作为 IDE 开发。
简要记录一下开发环境搭建,步骤如下:

  1. 系统使用 Ubuntu 24.04
  2. 安装必要软件
    sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
    
  3. VSCode 插件搜索并安装 ESP-IDF 插件
    /article/2025/10/09/esp-idf/esp-idf-01.png
  4. 配置下载开发包
    选择 Configure extension 配置插件版本等
    /article/2025/10/09/esp-idf/esp-idf-02.png
    点击 EXPRESS
    /article/2025/10/09/esp-idf/esp-idf-03.png
    配置版本,注意路径位置
    /article/2025/10/09/esp-idf/esp-idf-04.png
    等待完成
    /article/2025/10/09/esp-idf/esp-idf-05.png

验证

可以使用官方提供 LED 示例简单测试下环境是否搭建成功。

  1. 创建工程
    选择 New Project
    /article/2025/10/09/esp-idf/esp-idf-06.png
    填写工程信息,我使用的是 esp32s3 开发板,如果开发板已经上电连接,串口会自动选择
    /article/2025/10/09/esp-idf/esp-idf-07.png
    点击 Choose Template 选择 blink 示例
    /article/2025/10/09/esp-idf/esp-idf-08.png
    点击 Create Project using template blink 完成创建
  2. 配置引脚
    常用快捷按钮
    /article/2025/10/09/esp-idf/esp-idf-09.png
    点击配置,搜索 blink,配置引脚,我的开发板 LED 使用 GPIO45 引脚,配置如下:
    /article/2025/10/09/esp-idf/esp-idf-10.png
    点击 save 保存
  3. 编译运行
    点击编译,成功会输出如下信息
    /article/2025/10/09/esp-idf/esp-idf-11.png
    点击下载,成功后重启会看到 LED 闪烁

Shell

不使用 IDE,在 shell 中也可使用命令行编译下载。
在 shell 中执行以下命令:

# 该路径即 VSCode EXPRESS 配置的路径
export IDF_PATH=/opt/esp/v5.5.1/esp-idf
export IDF_TOOLS_PATH=/opt/esp/.espressif
source $IDF_PATH/export.sh

终端输出如下:

/article/2025/10/09/esp-idf/esp-idf-12.png