树莓派4B（Raspbian Linux）安装ESP-IDF工具链时遇路径不存在问题

云原生阿岚

2026-7-2

解决ESP-IDF v4.2在树莓派4B上安装时的目录不存在问题

报错的核心原因是~/esp/esp-idf目录尚未创建或源码克隆失败，按以下步骤执行即可解决：

首先创建并进入esp目录：
```
mkdir -p ~/esp
cd ~/esp
```
克隆ESP-IDF v4.2版本的源码（若树莓派未安装git，先执行sudo apt install git）：
```
git clone -b v4.2 --recursive https://github.com/espressif/esp-idf.git
```
如果GitHub克隆速度过慢，可替换为国内镜像地址：
```
git clone -b v4.2 --recursive https://gitee.com/EspressifSystems/esp-idf.git
```
若克隆过程中子模块拉取失败，执行以下命令补全子模块：
```
cd ~/esp/esp-idf
git submodule update --init --recursive
```
最后执行安装脚本：
```
cd ~/esp/esp-idf
./install.sh esp32
```