ESP-IDF 环境搭建一次搞定的 macOS 保姆级流程：3 步跑通 Hello world

ESP-IDF 环境搭建一次搞定的 macOS 保姆级流程：3 步跑通 Hello world

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf

如果你手边有一块 ESP32 开发板，想在 Mac 上从零搭好 ESP-IDF 环境搭建工具链、把 Hello world 烧进开发板，这条路线只花 20 分钟左右：装 3 个工具、跑 2 条脚本、编译 1 次，终点是串口监视器里滚出的Hello world!和 10 秒循环重启日志。

先看装完长什么样

不用听我描述，直接看终点画面。idf.py flash monitor跑完后，监视器里是这样的：

I (299) hello_world: Hello world! I (399) hello_world: Restarting in 10 seconds... I (999) hello_world: Restarting in 9 seconds...

看到Hello world!加上一秒一跳的重启倒计时，就说明 ESP-IDF 环境搭建整条链路——工具链、CMake、idf.py、烧录、串口——全部通了。

主线流程：3 步跑通

第 1 步｜装依赖 + 拿到代码

终端里，brew install负责装上 ESP-IDF 编译烧录必需的 CMake、Ninja 和 dfu-util；接着git clone把仓库拉到~/esp，看到Cloning into和百分比滚动就说明在正常下载：

brew install cmake ninja dfu-util git clone --depth 1 https://gitcode.com/GitHub_Trending/es/esp-idf ~/esp/esp-idf

网络慢的话加--depth 1只拉最新提交（上面已加）；想要完整提交历史，去掉这个参数即可。

第 2 步｜装工具链 + 激活环境

回到esp-idf目录跑./install.sh esp32，它把编译器、esptool、Python 依赖装进~/.espressif，最后出现DONE即完成。然后source ./export.sh激活环境——这一步是关键：PATH 没配好，后面所有idf.py都会报 command not found：

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

第 3 步｜编译烧录 Hello world

idf.py set-target esp32声明芯片型号并生成默认 sdkconfig；idf.py build首次编译要 2~5 分钟，结束标志是Project build complete。最后一条命令把固件烧进开发板并打开监视器，看到滚动日志里的Hello world!，就收工：

cd ~/esp/esp-idf/examples/get-started/hello_world idf.py set-target esp32 idf.py build idf.py -p /dev/cu.usbmodemXXX flash monitor

把/dev/cu.usbmodemXXX换成ls /dev/cu.*里看到的串口号。退出监视器按Ctrl+]。

卡住了？先对着这张表查

90% 的安装翻车都集中在这几处，每处只给一个最可能有效的动作：

镜像与 Rosetta 的两条命令：

export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" ./install.sh esp32

/usr/sbin/softwareupdate --install-rosetta --agree-to-license

第一条把工具下载源切到乐鑫服务器（国内用户可把值换成dl.espressif.cn/github_assets），第二条一条命令装完 Rosetta 2。

顺手优化，两分钟的事

工具链不想堆在~/.espressif？第 2 步执行前 export 一个路径就行，后续export.sh和所有脚本都会认它：

export IDF_TOOLS_PATH="$HOME/esp/tools"

不想每次开终端都敲一遍 source？官方推荐用别名而不是把 export.sh 写进.zshrc（避免每个终端都被 IDF 虚拟环境占用）。在~/.zshrc里加一行alias get_idf='source ~/esp/esp-idf/export.sh'，以后新终端敲get_idf就能进环境。

改完配置想进图形界面调参？idf.py menuconfig打开的就是这张界面，方向键加回车即可操作：

日常开发建议装 VS Code 的 Espressif IDF 扩展，编译、烧录、监视、调试都做成按钮，不用再记idf.py的参数顺序。

收尾：卡住了去哪查

ESP-IDF 环境搭建到这里就算落地：依赖、工具链、编译、烧录四件事各归其位，任何一步报错，先对照上面的速查表找对应症状。官方安装文档在 macOS 安装指南，更多可玩项目就在仓库的examples目录里，照着 hello_world 的套路改main目录下的 C 文件就行。

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf