Windows10下Eclipse IDE安装ESP-IDF失败求助

问题详情 #

已耗时两天排查，Python、Git、Java等所有前置依赖均已安装，Windows环境变量配置完成且工具可正常独立运行，但通过Espressif ESP-IDF Tools管理器安装时，仍出现两个核心问题：

1. 持续弹出WARNING: Git was not found提示
2. 抛出FileNotFoundError，提示找不到路径C:\Espressif\frameworks\esp-idf-v5.0.1\tools\idf.py\tools/tools.json

环境变量配置 #

用户变量（deans） #

• C:\Users\deans\AppData\Local\Programs\Microsoft VS Code\bin
• D:\Java\jdk-20\bin
• C:\Espressif\tools\idf-python\3.11.2\python.exe
• C:\Espressif\tools\idf-git\2.39.2\mingw64\bin\git.exe
• C:\Program Files\Git\bin
• C:\Users\deans\AppData\Local\Programs\Python\Python311

系统变量 #

• C:\Python27
• C:\Python27\Scripts
• C:\Program Files\Espressif\ESP-IDF Tools\mconf-idf
• C:\Program Files\Espressif\ESP-IDF Tools\tools\bin
• D:\Java\jdk-20\bin
• C:\Espressif\tools\idf-python\3.11.2\python.exe
• C:\Espressif\tools\idf-git\2.39.2\mingw64\bin\git.exe
• C:\Users\deans\AppData\Local\Programs\Python\Python311
• C:\Program Files\Git\bin
• C:\Program Files\CMake\bin

使用的软件版本 #

• Eclipse IDE：2023-03 (4.27.0)
• Python：已测试3.7（32位）、3.11版本

完整报错日志 #

Installing tools...
This can take a while. Please be patient.
Executing C:\Users\deans\AppData\Local\Programs\Python\Python37-32\python.exe D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py install all
Traceback (most recent call last):
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 1855, in <module>
main(sys.argv[1:])
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 1851, in main
action_func(args)
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 1406, in action_install
tools_info = load_tools_info()
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 937, in load_tools_info
with open(tool_versions_file_name, 'r') as f:
FileNotFoundError: [Errno 2] No such file or directory: 'C:\Espressif\frameworks\esp-idf-v5.0.1\tools\idf.py\tools/tools.json'
ErrorError

Executing C:\Users\deans\AppData\Local\Programs\Python\Python37-32\python.exe D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py install-python-env
WARNING: Git was not found
WARNING: Is it not possible to determine the IDF version: [Errno 2] No such file or directory: 'C:\Espressif\frameworks\esp-idf-v5.0.1\tools\idf.py\components\esp_common\include\esp_idf_version.h'
ERROR: IDF version cannot be determined
ErrorError

Executing C:\Users\deans\AppData\Local\Programs\Python\Python37-32\python.exe D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py export --format=key-value
Traceback (most recent call last):
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 1855, in <module>
main(sys.argv[1:])
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 1851, in main
action_func(args)
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 1165, in action_export
tools_info = load_tools_info()
File "D:\ESP-IDF\esp-idf-v4.3.5\tools\idf_tools.py", line 937, in load_tools_info
with open(tool_versions_file_name, 'r') as f:
FileNotFoundError: [Errno 2] No such file or directory: 'C:\Espressif\frameworks\esp-idf-v5.0.1\tools\idf.py\tools/tools.json'

解决方案 #

1. 修复IDF版本路径冲突 #

日志显示核心矛盾：运行的是esp-idf-v4.3.5的工具脚本，但系统试图读取esp-idf-v5.0.1的文件，属于路径配置混乱：

• 删除C:\Espressif\frameworks\esp-idf-v5.0.1目录（若为误安装或残留文件）
• 检查Eclipse及IDF Tools管理器的配置，确保指向的是D:\ESP-IDF\esp-idf-v4.3.5，而非v5.0.1路径

2. 修正Git环境变量配置 #

环境变量中直接添加了git.exe的完整路径，而非Git的bin目录，导致工具无法识别：

• 从用户变量和系统变量中移除C:\Espressif\tools\idf-git\2.39.2\mingw64\bin\git.exe，仅保留C:\Espressif\tools\idf-git\2.39.2\mingw64\bin
• 将C:\Program Files\Git\bin移至环境变量列表的最顶端，避免被其他路径覆盖
• 重启所有终端和IDE，执行git --version验证Git是否能正常识别

3. 清理Python环境冲突 #

系统中同时存在Python27和Python3.x，可能导致工具调用错误：

• 暂时移除系统变量中的C:\Python27和C:\Python27\Scripts，优先使用Python3.11或IDF自带的Python环境
• 配置IDF Tools管理器使用C:\Espressif\tools\idf-python\3.11.2\python.exe，而非系统中的Python37-32

4. 重新初始化IDF环境 #

• 打开命令提示符，进入D:\ESP-IDF\esp-idf-v4.3.5目录
• 执行install.bat重新安装工具依赖
• 执行export.bat配置环境变量，之后再尝试通过IDE完成安装

内容的提问来源于stack exchange，提问作者Dean Sarelius