ESP32开发环境建立小结（传统 GNU Make）

最新推荐文章于 2026-04-24 09:32:29 发布

原创

最新推荐文章于 2026-04-24 09:32:29 发布 · 3.3k 阅读

标签

#ESP32

本文详细介绍了在Windows环境下搭建ESP32开发环境的步骤，包括下载工具链、配置环境变量、安装依赖、编译及下载固件到开发板的过程，解决了多个常见错误，适合初学者快速上手。

1. 在页面https://docs.espressif.com/projects/esp-idf/zh_CN/latest/get-started-legacy/windows-setup.html下载工具链文件https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20190611.zip。

2. 解压esp32_win32_msys2_environment_and_toolchain-20190611.zip到磁盘根目录，比如d盘，下载esp-idf

cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git

本地签出至 master 分支:

cd $IDF_PATH
git checkout master
git pull
git submodule update --init --recursive

更新至v3.3版本

cd $IDF_PATH
git fetch
git checkout release/v3.1
git pull
git submodule update --init --recursive

3. 找到esp-idf目录下的tools/windows/windows_install_prerequisites.sh文件，执行，可能报错：

*** fatal error - cygheap base mismatch detected - 0x612E5408/0x612E4408

解决办法：关掉当前窗口，重新打开一个新窗口重新执行windows_install_prerequisites.sh命令即可。

参考页面：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/get-started-legacy/windows-setup-scratch.html

4. 设置环境变量参考页面：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/get-started-legacy/add-idf_path-to-profile.html

1> 在 d:/msys32/etc/profile.d/ 目录下创建一个新的脚本文件，并将其命名为 export_idf_path.sh。

指定您的 ESP-IDF 保存路径，这通常与您的系统配置有关，比如 d:\msys32\home\user-name\esp\esp-idf。

2> 在脚本文件中加入下方 export 命令行，例:

export IDF_PATH="D:/msys32/home/user-name/esp/esp-idf"
注意请将反斜杠替换为 Windows 操作系统路径要求的正斜杠。

3> 保存脚本文件。

4> 关闭 MSYS2 窗口，并重新打开。运行以下命令，检查 IDF_PATH 是否成功设置:

printenv IDF_PATH
如果设置成功，则此时将打印之前在脚本中输入的路径。

5. 安装requirements.txt

报如下错误：将python改为python2.7(D:\msys32\mingw32\bin\python2.7.exe）

/bin/sh: python: 未找到命令
make[1]: *** [/home/A

最低0.47元/天解锁文章