一、安装基础工具
- 安装VSCode
下载并安装Visual Studio Code,选择默认配置即可。
二、安装ESP-IDF开发框架
方法1:VSCode插件安装(推荐)
-
安装ESP-IDF插件
- 在VSCode扩展商店搜索“Espressif IDF”,安装版本1.2.0(避免1.3.0的已知问题)。
- 通过命令面板(
Ctrl+Shift+P
)运行 英文输入ESP-IDF: Configure ESP-IDF extension
,选择 Express 安装模式。(前往菜单栏 查看 > 命令面板,中文 输入 ESP-IDF: 配置 ESP-IDF 扩展,选中该命令以启动设置向导。用户界面将显示加载通知,随后出现设置向导)
-
配置安装路径
- 设置ESP-IDF框架路径(如
D:\ESP32-IDF\esp
)和工具路径(如D:\ESP32-IDF\.espressif
),确保路径无中文或空格。
- 设置ESP-IDF框架路径(如
-
选择版本与服务器
- 推荐选择 v5.2(稳定版)和 Github服务器 下载。
确保 IDF_TOOLS_PATH 中没有空格,避免出现构建问题。
此外,要注意 IDF_TOOLS_PATH 与 IDF_PATH 不能在相同目录下。
等待安装完成
方法2:官方离线安装包
- 下载并运行
espressif-ide-setup-2.7.0-with-esp-idf-4.4.3.exe
,按向导完成安装,选择中文界面和默认组件。
离线安装下载:
https://dl.espressif.cn/dl/esp-idf/?idf=4.4
三、配置开发板驱动
-
安装USB驱动
- CP210x(常见于ESP32 DevKitC):从Silicon Labs官网下载安装。
- FTDI(部分开发板):从FTDI官网下载驱动。
-
确认串口端口
连接开发板后,在设备管理器中查看分配的COM号(如COM3)。
如需完整代码或更多配置细节,可参考乐鑫官方文档。
参考:
esp-idf
https://docs.espressif.com/projects/esp-idf/zh_CN/v5.4.1/esp32s3/index.html
https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/index.html
https://docs.espressif.com/projects/esp-idf/zh_CN/v5.4.1/esp32s3/get-started/windows-setup.html