esp32-idf Linux 环境安装教程

 一、提前说明

1. 系统环境 Ubuntu22.04

2. 适配芯片 ESP32S3

3. idf版本 v5.4.1(截止2025年4月13日为最新版本)

二、安装步骤

1. 安装前置依赖

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

这一步一般不会有问题

2. 获取IDF源码

mkdir -p ~/esp # 在根目录创建用于存储esp-idf资料的目录
cd ~/esp # 进入到创建的目录
git clone -b v5.4.1 --recursive https://github.com/espressif/esp-idf.git # 指定版本克隆esp-idf资料

成功后的目录结构 

3. 设置工具

cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" # 换到国内服务器
./install.sh # 运行安装脚本

成功后的日志 

4. 设置环境变量

# 在需要运行idf环境的地方执行下面的指令
. $HOME/esp/esp-idf/export.sh

操作截图 

5. 编译验证

进入hello world的目录，编译hello world项目，如果环境正确，则能正常编译

. $HOME/esp/esp-idf/export.sh # 已经设置环境变量的可以忽略
idf.py build