一、准备事项

Ubuntu 18.04.5。具体安装可以参考如下链接。使用VMware安装Ubuntu虚拟机和VMware Tools_t_guest的博客-CSDN博客

乐鑫官方也提供了安装的相关操作。有兴趣可以参考。

快速入门 - ESP32 - — ESP-IDF 编程指南 v5.0.1 文档

注：提前说明，因为ESP-IDFV5.0的版本比较高，编译所需要的python和cmake版本都比较高，而ubuntu18.4环境的这些软件版本都不满足，需要做额外升级。不喜欢麻烦的同学可以直接看下一篇文章，用高版本的ubuntu来安装ESP-IDFV5.0。

ESP32学习三-环境搭建（ESP-IDF V5.0，Ubuntu20.4）_t_guest的博客-CSDN博客

有头铁的同学可以继续往下阅读。

二、安装IDF

1.安装必要的工具链

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

如果系统报错，可以在指令的最后加上--fix-missing。

一定要保证所有工具链都安装了，否则后续安装会出错。

成功的标志如下：

2.安装ESP-IDF

2.1获取ESP-IDF

通过如下代码来获取ESP-IDF。

mkdir ~/esp
cd ~/esp
git clone -b release/v5.0 --recursive https://github.com/espressif/esp-idf.git

成功后显示如下

2.2设置工具

这里根据自己使用的芯片来。以ESP32为例

cd ~/esp/esp-idf
./install.sh esp32

如果需要为多个目标芯片开发项目，则可以一次性指定多个目标，如下所示:

cd ~/esp/esp-idf 
./install.sh esp32,esp32s2

ESP-IDF 工具安装器会下载 Github 发布版本中附带的一些工具，如果访问 Github 较为缓慢，可以设置一个环境变量，从而优先选择 Espressif 的下载服务器进行 Github 资源下载。

要在安装工具时优先选择 Espressif 下载服务器，请在运行 install.sh 时使用以下命令：

cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"
./install.sh

注：如果使用的IDF的版本比较新，需要python的版本就会比较高，比如我们下载的IDF版本是5.0即以上。那么需要的python版本就必须是3.7或者更高的版本。如果此时python版本低于3.7.则会直接报错。

此时，需要更新自己的python版本。关于如何升级python版本，见另一篇文章。

ESP32学习二-更新Python版本(Ubuntu)_t_guest的博客-CSDN博客

升级成功后，再次安装。

继续报错，提示没有python3的虚拟环境。

按如下文章链接解决。

https://blog.csdn.net/qq_26226375/article/details/130264752?csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22130264752%22%2C%22source%22%3A%22qq_26226375%22%7D

修复后，再次运行安装

./install.sh

安装成功！

三、编译

设置环境变量。

cd ~/esp/esp-idf
. ./export.sh

设置环境变量成功。切换到demo工程下，编译工程。

cd examples/get-started/hello_world
idf.py build

又报错。提示cmake的版本过低。

按照如下链接进行修复。

https://blog.csdn.net/qq_26226375/article/details/130265617?csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22130265617%22%2C%22source%22%3A%22qq_26226375%22%7D

修复后，再次运行idf.py build