Wiki

ESP32環境搭建

更新於 2026-01-07約 14 分鐘閱讀

本文由簡體中文內容確定性轉換，並受版本化術語表保護。

1.Linux

開啟下面的網站, https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/linux-macos-setup.html

1.1.安裝依賴

alt text

第一步按照這個網站所示,如果你是Ubuntu

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

如果你是Fedora

sudo dnf -y makecache && sudo dnf install git wget flex bison gperf python3 python3-setuptools cmake ninja-build ccache dfu-util libusbx

alt text

1.2.獲取 ESP-IDF

alt text

看看目前最新穩定版是哪個版本

alt text

如上圖所示,為5.5.2版本. 接下來,你選擇一個你要存放韌體的資料夾, 比如我要放在/home/tungchiahui/UserFolder/Applications/資料夾下(其中/home/tungchiahui可用~/代替) 那麼

cd ~/UserFolder/Applications
mkdir -p ./esp
cd ./esp
# 记得版本号要改成最新稳定版(网络环境一定要好)
git clone -b v5.5.2 --recursive https://github.com/espressif/esp-idf.git

alt text

如圖才是成功,不是下面這樣的都是沒下載成功的 alt text

1.3.設定工具

alt text

cd ./esp-idf
# 选择国内服务器
export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
./install.sh all

alt text

上圖就是成功的樣子,這裡要複製一下我紅色圈起來的東西(export.sh的路徑),下一個環境配置中要使用,比如我這裡複製下來的路徑是 ~/UserFolder/Applications/esp/esp-idf/export.sh

1.4.設定環境變數

此時，剛剛安裝的工具尚未新增至 PATH 環境變數，無法通過“命令視窗”使用這些工具。因此，必須設定一些環境變數。這可以通過 ESP-IDF 提供的另一個指令碼進行設定。

vim ~/.bashrc

新增下面這句(這裡要填你具體存放的路徑,也就是剛才複製的那串路徑,記得把~改成$HOME,增加健壯性)

alias get_idf='. $HOME/UserFolder/Applications/esp/esp-idf/export.sh'

alt text

source ~/.bashrc

alt text

1.5.配置VScode

https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/index.html

安裝ESP-IDF外掛

alt text

點選 Express 並選擇下載伺服器：

按下圖的選,因為我們剛才配置過環境了,這裡不要再選擇版本了,直接去選擇從我的電腦裡找到ESP-IDF

alt text

他會自動幫你補全所有工具鏈

alt text

右下角這麼顯示則為成功

alt text

緊接著要配置 openOCD : alt text 複製上面這行,並開終端(任意終端都行,不用管路徑)執行

sudo cp --update=none /home/tungchiahui/.espressif/tools/openocd-esp32/v0.12.0-esp32-20250707/openocd-esp32/share/openocd/contrib/60-openocd.rules /etc/udev/rules.d

alt text