ESP-IDF编译执行命令时卡在Found Git提示，如何解决？

开发者阿泽

2026-8-20

解决ESP-IDF在Windows下运行命令卡住的问题

常见排查与修复步骤

清空Git代理配置
多数情况下是Git代理导致的进程阻塞，打开ESP-IDF命令提示符，执行以下命令清空全局代理：
```
git config --global --unset http.proxy
git config --global --unset https.proxy
```
完成后重新运行idf.py menuconfig或闪烧命令。
临时禁用CCACHE
命令中的CCACHE_ENABLE=1可能引发缓存阻塞，尝试临时禁用CCACHE：
```
idf.py set-target esp32
idf.py -DCCACHE_ENABLE=0 menuconfig
```
若能正常运行，后续可清理CCACHE缓存后重新启用：
```
ccache -C
```
重建项目构建目录
进入项目目录，删除build文件夹并执行全量清理：
```
rmdir /s /q build
idf.py fullclean
idf.py menuconfig
```
排查安全软件拦截
Windows Defender或第三方防火墙可能拦截CMake、Git的网络请求，临时关闭实时保护，或把ESP-IDF工具目录（默认C:\Espressif）加入白名单后重试。
更新ESP-IDF工具链
执行命令更新所有工具到最新版本：
```
idf.py install
idf.py upgrade
```
检查项目路径合法性
确保项目路径无中文、空格或特殊字符，建议使用纯英文路径避免兼容性问题。