目的：在ubuntu下開發(fā)ESP-IDF。

主要參考的是樂(lè)鑫的官方文檔，在安裝過(guò)程中會(huì)遇到各種各樣的問(wèn)題，在此記錄。

官方文檔：樂(lè)鑫 | Linux 和 macOS 平臺(tái)工具鏈的標(biāo)準(zhǔn)設(shè)置

https://docs.espressif.com/projects/esp-idf/zh_CN/v5.1/esp32/get-started/linux-macos-setup.html#get-started-set-up-tools

1、安裝準(zhǔn)備

這里按照官方的指南，對(duì)于ubuntu需要執(zhí)行命令：

命令的作用是一次性安裝了一大堆ESP-IDF需要的組件，例如git、python3、cmake等等。筆者一開始也是執(zhí)行的這條命令，但是后面遇到了python3版本過(guò)低、CMake版本過(guò)低的問(wèn)題。

在恢復(fù)快照重新嘗試安裝時(shí)，我執(zhí)行的時(shí)下述命令，只是將python3改為了3.7（ESP-IDF所需的最低版本的python），在后續(xù)過(guò)程中沒(méi)有提示我python的問(wèn)題，但是python虛擬環(huán)境的問(wèn)題還是會(huì)遇到。

2、獲取 ESP-IDF

這里建議直接執(zhí)行官方文檔的命令：

在 ~/esp/esp-idf目錄克隆idf的倉(cāng)庫(kù)，這里對(duì)網(wǎng)速有一定要求，而且需要能穩(wěn)定訪問(wèn)github，具體還得看自己的情況了。

2.1 Github拒絕連接

還有的情況就是網(wǎng)頁(yè)能夠順暢訪問(wèn)github，但是在clone的過(guò)程中，一開始還可以clone一些，但是后面會(huì)報(bào)錯(cuò)拒絕連接：

這里的情況有可能是科學(xué)上網(wǎng)走了代理，但是clone的時(shí)候沒(méi)有走代理。還有可能就是單純地不穩(wěn)定、慢。

筆者用下面的方法2成功克隆了。

1）使用代理

在科學(xué)上網(wǎng)的時(shí)候，讓git也走代理

如果不想用代理了，取消代理也很簡(jiǎn)單：

還有就是查看代理狀態(tài)：

2）CDN加速

CDN不需要科學(xué)上網(wǎng)，小白友好。在克隆主倉(cāng)庫(kù)的時(shí)候，筆者的速度甚至來(lái)到過(guò)11MB/s（差不多是百兆網(wǎng)的上限了）。

上述三個(gè)命令任選一個(gè)即可，親測(cè)第一個(gè)有效（2023年8月12日），但是這些都是為愛(ài)發(fā)電的CDN，指不定能用到啥時(shí)候，且用且珍惜。

3）使用國(guó)內(nèi)的gitee

樂(lè)鑫在Gitee也是有倉(cāng)庫(kù)的：https://gitee.com/EspressifSystems/esp-idf

理論上只要把clone的鏈接換成Gitee的鏈接就可以了，但是筆者沒(méi)有嘗試過(guò)。

如果克隆中斷了，或者是升級(jí)IDF，可以在IDF的根目錄執(zhí)行：

3、設(shè)置工具

除了 ESP-IDF 本身，您還需要為支持 ESP32 的項(xiàng)目安裝 ESP-IDF 使用的各種工具，比如編譯器、調(diào)試器、Python 包等。

這里官方可以單純安裝某一些芯片的工具，但是我建議全都要。

這一步驟，筆者在第一節(jié)安裝準(zhǔn)備的時(shí)候執(zhí)行的是官方的命令，由于ubuntu18已經(jīng)安裝了python3.6.9了，并沒(méi)有實(shí)際安裝ESP-IDF所需的python版本（3.7以上），所以這一步一直報(bào)錯(cuò)，如果上述步驟讀者執(zhí)行的是筆者給出的推薦的命令，那就不需要其他操作了，耐心等待就好了。

3.1 python虛擬環(huán)境創(chuàng)建失敗

在這個(gè)步驟中，安裝了到一半，筆者遇到了以下提示：

大致意思就是python3.7的虛擬環(huán)境創(chuàng)建失敗，終端提示運(yùn)行

但是多次嘗試后還是一樣的問(wèn)題。最后的解決方法是指定安裝虛擬環(huán)境的版本：

然后終端會(huì)提示更新了，還會(huì)建議我們卸載不需要的軟件包，在卸載玩之后需要在執(zhí)行一次上述命令。之后再設(shè)置工具就完成啦。

成功之后，會(huì)在終端看到類似圖示的內(nèi)容。

如果訪問(wèn)github網(wǎng)速不穩(wěn)定，樂(lè)鑫也很貼心給了鏡像網(wǎng)站：

下載工具備選方案?ESP-IDF 工具安裝器會(huì)下載 Github 發(fā)布版本中附帶的一些工具，如果訪問(wèn) Github 較為緩慢，可以設(shè)置一個(gè)環(huán)境變量，從而優(yōu)先選擇 Espressif 的下載服務(wù)器進(jìn)行 Github 資源下載。 備注 該設(shè)置只影響從 Github 發(fā)布版本中下載的單個(gè)工具，它并不會(huì)改變?cè)L問(wèn)任何 Git 倉(cāng)庫(kù)的 URL。 要在安裝工具時(shí)優(yōu)先選擇 Espressif 下載服務(wù)器，請(qǐng)?jiān)谶\(yùn)行 install.sh 時(shí)使用以下命令：

4、設(shè)置環(huán)境變量

此時(shí)，您剛剛安裝的工具尚未添加至 PATH 環(huán)境變量，無(wú)法通過(guò)“命令窗口”使用這些工具。因此，必須設(shè)置一些環(huán)境變量。這可以通過(guò) ESP-IDF 提供的另一個(gè)腳本進(jìn)行設(shè)置。 請(qǐng)?jiān)谛枰\(yùn)行 ESP-IDF 的終端窗口運(yùn)行以下命令：

但是每次打開一個(gè)終端就執(zhí)行一次這個(gè)文件，還得記住這個(gè)路徑，顯然是不優(yōu)雅的，那怎么優(yōu)雅起來(lái)呢？樂(lè)鑫也是很懂大家哈。

如果您需要經(jīng)常運(yùn)行 ESP-IDF，您可以為執(zhí)行 export.sh 創(chuàng)建一個(gè)別名，具體步驟如下： 復(fù)制并粘貼以下命令到 shell 配置文件中（.profile、.bashrc、.zprofile 等）

通過(guò)重啟終端窗口或運(yùn)行 source [path to profile]，如 source ~/.bashrc 來(lái)刷新配置文件。 現(xiàn)在您可以在任何終端窗口中運(yùn)行 get_idf 來(lái)設(shè)置或刷新 esp-idf 環(huán)境。

這里筆者修改的配置文件是bashrc。

到這一步，基本上就是成功啦，

5、開始使用 ESP-IDF 吧

這里就不按官方的來(lái)了。我們直接進(jìn)入IDF的目錄，按路徑~/esp/esp-idf/example/get-started/hello_world展開，將整個(gè)hello_world文件夾復(fù)制，在粘貼到自己的工程路徑（例如我是在~/esp/Prj文件夾下），然后在空白處右鍵，在終端打開。在終端輸入get_idf導(dǎo)入IDF環(huán)境。

之后就是設(shè)置目標(biāo)芯片，可以使用命令：

這里根據(jù)自己手上的開發(fā)板實(shí)際選擇，筆者的是ESP32-C3。

4.1 CMake版本太低

ESP-IDF是以CMake來(lái)進(jìn)行工程管理的，對(duì)CMake的版本有最低要求，筆者的版本還是太低了，所以需要進(jìn)行CMake版本的升級(jí)。

具體的報(bào)錯(cuò)信息可參考：

大致意思就是CMake的版本太低了，需要升級(jí)版本。

1)下載cmake

2)解壓

3)先進(jìn)入解壓后的目錄，再執(zhí)行以下命令進(jìn)行配置

配置成功會(huì)顯示：

失敗情況有：

這里提示少了C編譯器，安裝就好了

4)配置完之后進(jìn)行編譯

5)編譯完之后進(jìn)行安裝

6)替換舊版本，。

其中/usr/local/bin/cmake為新安裝的cmake目錄

7)最后測(cè)試cmake版本：

成功升級(jí)CMake的版本之后，也是很順利地設(shè)置了目標(biāo)芯片，可以愉快編譯啦：

這里大家可以體會(huì)到在Linux環(huán)境下，IDF 編譯的速度變化，筆者的物理機(jī)是i5-12500 ? 3.00 GHz，普普通通12代i5，而虛擬機(jī)才倆核心，編譯的速度基本上差不多的，那我要是多分幾個(gè)核給虛擬機(jī)，蕪湖~。

編譯完成之后可以開始燒錄了，這里接上設(shè)備之后，可以使用

來(lái)查看當(dāng)前掛載的設(shè)備。例如筆者當(dāng)時(shí)的設(shè)備如下圖，而插入的開發(fā)板在圖中的最后一行倒數(shù)第三個(gè)：ttyUSB0。

確認(rèn)當(dāng)前的設(shè)備端口后，就可以開始燒錄啦：

-p后面的端口號(hào)要根據(jù)讀者的參數(shù)進(jìn)行調(diào)整。這里燒錄可能會(huì)提示報(bào)錯(cuò)：

省流：沒(méi)有寫串口的權(quán)限。那打開權(quán)限就完事了，直接：

再次進(jìn)行燒錄就莫問(wèn)題啦。猜你想要打開串口查看調(diào)試信息：

又或者一鍵燒（san）錄（lian）：

結(jié)束

遇到的問(wèn)題不一定一樣，但是可以做個(gè)參考

可參看視頻教程

（待錄）

參考鏈（wen）接（xian）

1、github 代理加速或 CDN 加速 - thepoy - 博客園 (cnblogs.com)

https://www.cnblogs.com/thepoy/p/14848080.html

2、Ubuntu升級(jí)Cmake的正確方式_Liangtao`的博客-CSDN博客

https://blog.csdn.net/qq_27350133/article/details/121994229