ESP32 | Mac OS 搭建 ESP-IDF 开发环境（V4.4 版本）

使用 Mac 搭建 ESP32 开发环境踩坑记录

参考文档：ESP-IDF编程指南

一、安装准备

1. 安装USB转串口驱动

驱动下载地址：CP210x USB to UART Bridge VCP Drivers

2. 安装 pip

sudo easy_install pip

3. 安装 CMake 和 Ninja 编译工具

brew install cmake 
brew install --cask binary-ninja
brew install dfu-util

4. 安装 ccache 以获得更快的编译速度。

brew install ccache 

二、获取 ESP-IDF

打开终端，运行以下命令：

mkdir -p ~/esp
cd ~/esp

接下来一步，官网给的命令是：

git clone -b v4.4 --recursive https://github.com/espressif/esp-idf.git

但我实际运行发现因为网络问题总是失败，所以用以下两条命令替换：

git clone -b v4.4 https://github.com/espressif/esp-idf.git
git submodule update --init --recursive

运行第二条指令时也会因为网络问题遇到失败情况，可以重复运行直到没有包需要clone：

三、设置工具

安装 ESP-IDF 使用的各种工具，比如编译器、调试器、Python 包等。

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

四、设置环境变量

. $HOME/esp/esp-idf/export.sh

为执行 export.sh 创建一个别名，步骤如下：

vim ~/.bashrc

将以下命令添加进去：

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

使用 source ~/.bashrc 刷新配置文件。

之后在终端输入 get_idf 即可设置或刷新 esp-idf 环境。

五、创建工程

拷贝工程至目录下：

cd ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world .

六、连接设备

将板子接到电脑上，使用 ls /dev/cu.* 查看串口：

七、配置工程

cd ~/esp/hello_world
idf.py set-target esp32

八、编译工程

idf.py build

生成可以烧录进板子的.bin文件

九、烧录至开发板

idf.py -p /dev/cu.SLAB_USBtoUART flash

在下载时如果遇到无法连接ESP32的错误，可以按住下图中的boot键不放再下载即可：

查看输出

idf.py -p /dev/cu.SLAB_USBtoUART monitor

使用 control+] 停止打印：