ESP32 配置开发环境

作者：追风剑情发布于：2026-5-22 10:39 分类：物联网

一、安装 VSCode

Download Visual Studio Code

二、安装 VSCode 扩展

ESP-IDF 扩展选择 1.11.1 版本，新版本有 bug。

三、安装 ESP-IDF 框架

下载 ESP-IDF v5.3.5 - Offline Installer

下载完后，以管理员身份运行 esp-idf-tools-setup-offline-5.3.5.exe，一直点击下一步即可。

可以用 cmd 命令 echo %IDF_PATH% 查看 ESP-IDF 框架安装目录。

四、打开配置向导

按 F1，输入 ESP-IDF: Configure ESP-IDF

五、创建新项目

也可以输入命令创建新工程。按 F1，输入 ESP-IDF: Create New Project

点击【Choose Template】

六、安装驱动

需要根据自己的芯片安装对应的驱动：
CH340驱动

驱动安装好后，连接上 ESP32 开发板，在设备管理器里看看有没这个设备，并观察下用的是 COM3 还是 COM4 端口。

VSCode 中输入命令 ESP-IDF: Select Port to Use，选择您在设备管理器中看到的端口（例如 COM3）

七、安装 Python

ESP32 开发需要 Python 3.11 环境。可以用 conda 命令创建一个虚拟环境 conda create -n esp32-env python=3.11

安装 ESP32 开发需要的依赖
pip install setuptools wheel pyyaml pyserial future cryptography pyparsing

八、配置环境变量

需要根据自己的实际路径配置：
IDF_PATH：C:\Espressif\frameworks\esp-idf-v5.3.5
IDF_TOOLS_PATH：C:\Espressif
Path：%IDF_PATH%\tools;%IDF_TOOLS_PATH%\tools

重启电脑，使环境变量生效。

九、烧录测试程序

方法一：在专用终端中执行烧录

在桌面找到 ESP-IDF 5.3 PowerShell 或 ESP-IDF 5.3 CMD 图标，或在菜单中找到这两个快捷项。

执行以下命令：
cd D:\ESP32Project\LedFlash
idf.py -p COM3 flash

# 清空缓存
idf.py fullclean
# 重新配置和构建项目，有时添加了新依赖包后（或修改了 idf_component.yml），CMake 未识别到时需执行下此命令
idf.py reconfigure
# 如果修改了分区，需要执行完全擦除闪存命令，再重新编译烧录
idf.py erase-flash
# 设置编译的目标芯片：esp32、esp32s3、esp32c3
idf.py set-target esp32
# 列出每个组件对 IRAM 的占用情况
idf.py size-components
# 编译代码
idf.py build
# 烧录并监视日志输出
idf.py -p COM3 flash monitor

方法二：点击 VSCode 底部状态栏上的烧录图标

如果命令行弹出列表，让你选择烧录方式，直接选择 UART(usb转串口)。

点击底部状态栏的监视设备图标可以查看程序打印日志，按 Ctrl+] 键退出监视日志。

十、查看开发板参数信息

根据自己的电脑改成实际的COM端口：
python -m esptool --port COM3 flash_id

十一、更改监视器的波特率

快捷键 ctrl+, 打开“设置”，“用户”->“扩展”->“ESP-IDF”->“Monitor Baud Rate”

注意：监视器的波特率必须与ESP32芯片的波特率保持一致。

进入配置文件修改ESP32使用的波特率：
"idf.py menuconfig" -> "Component config" -> "ESP System Settings" -> "Channel for console output" -> "Custom UART" -> "UART console baud rate"