ESP32 SDK 开发(二)——ESP32/ESP-IDF环境搭建-linux

最新推荐文章于 2025-10-29 17:54:01 发布

原创

最新推荐文章于 2025-10-29 17:54:01 发布 · 3k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#esp32 #esp-idf #物联网

本文详细指导如何在Ubuntu 18上安装和配置ESP-IDF环境，包括软件包的安装、获取ESP-IDF仓库、设置工具、环境变量和配置，以及烧录与调试过程，适合ESP32开发者入门。

ubuntu18搭建ESP_IDF环境

参考资料

官方文档：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html

1. 安装准备:

编译 ESP-IDF 需要以下软件包。请根据使用的系统，选择合适的安装命令，如下所示：

Ubuntu 和 Debian:

sudo apt-get install git wget flex bison gperf python3 python3-pip python3-setuptools cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

CentOS 7 & 8:

sudo yum -y update && sudo yum install git wget flex bison gperf python3 python3-pip python3-setuptools cmake ninja-build ccache dfu-util libusbx

目前仍然支持 CentOS 7，但为了更好的用户体验，建议使用 CentOS 8。

Arch:

sudo pacman -S --needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util libusb

注解

使用 ESP-IDF 需要 CMake 3.5 或以上版本。较早的 Linux 发行版可能需要升级自身的软件源仓库，或开启 backports 套件库，或安装 “cmake3” 软件包（不是安装 “cmake”）。
如果上述列表中，并没有您使用的系统，请参考您所用系统的相关文档，查看安装软件包所用的命令。
如果在安装过程中出现依赖，而且一直不能解决依赖，建议更换软件源，亲测清华源完美解决。更换方法：https://www.jianshu.com/p/206dd6d34f00 建议使用命令方式修改
ESP-IDF 支持 Python 3.6 及以上版本，建议升级操作系统到最新版本从而更新 Python。也可选择从 sources 安装最新版 Python，或使用 Python 管理系统如 pyenv 对版本进行升级管理。

2. 获取ESP—IDF

在围绕 ESP32 构建应用程序之前，请先获取乐鑫提供的软件库文件 ESP-IDF 仓库。

获取 ESP-IDF 的本地副本：打开终端，切换到您要保存 ESP-IDF 的工作目录，使用 git clone 命令克隆远程仓库。针对不同操作系统的详细步骤，请见下文。

打开终端，后运行以下命令：

mkdir -p ~/esp
cd ~/esp
git clone  -b v4.3 https://gitee.com/EspressifSystems/esp-idf.git
下载子模块参考：https://gitee.com/EspressifSystems/esp-gitee-tools/blob/master/docs/README-submodule-update.md

ESP-IDF 将下载至 ~/esp/esp-idf。