MacOS+VSCODE 安装esp-adf详细流程

猪哥-嵌入式2025-05-07 8:11

安装python3，省略
vscode安装ESP-IDF插件，选择v5.2.5 版本，电脑需要能够访问github，esp-idf安装后的默认目录是:

shell 复制代码

/Users/***/esp/v5.2.5/esp-idf

# 启动***为省略名称

在/Users/***/esp/ 目录下使用git clone 下载 esp-adf

shell 复制代码

# 国内用户推荐 Gitee 镜像
git clone https://gitee.com/EspressifSystems/esp-adf.git

esp-idf 子模块下载

shell 复制代码

# 手动下载子模块（解决 GitHub 访问问题）：
# 安装esp-adf-libs:
git clone https://gitee.com/du-jianmin/esp-adf-libs.git 
# → 放入 esp-adf/components/
# 安装esp-sr:
git clone https://gitee.com/du-jianmin/esp-sr.git 
# → 放入 esp-adf/components/
注意：无需处理 esp-idf 子模块（已独立安装）

创建esp-idf 软链接指向esp-idf，重要.
这里吐槽一下esp32官方的环境搭建，很麻烦，因为在esp-adf目录下有esp-idf子目录（空目录），因为esp-adf依赖esp-idf，而前面我们已经安装了esp-idf，所以我们不需要再次clone esp-idf，而是通过软链接的方式指向真正的esp-idf即可，这一步非常重要，否则在执行export.sh 的时候会报错。

shell 复制代码

# 7.1 删除esp-adf/esp-idf
rm -rf esp-idf
# 7.2 创建esp-idf 软链接
ln -s /User/***/esp/v5.2.5/esp-idf /User/***/esp/esp-adf/esp-idf

创建 ADF_PATH 变量

shell 复制代码

cd ~/esp/esp-adf
. /User/***/esp/esp-adf/export.sh

配置vscode路径，重要

10.1 vscode 选择esp-idf插件，set按钮
10.2 选择settings
10.3 设置esp-idf、esp-adf的路径，重要