安装esp-idf时报错无法解决：ERROR: Failed to check the tool while installed

[Huxley2004]

使用Windows环境下的在线安装工具esp-idf-tools-setup-online-2.3.4.exe，安装esp-idf的5.4版本时，总是在安装tools中的ccache时失败，尝试过更换官网ccache包、手动安装ccache，均以失败告终。安装log报错部分：
Current system platform: win64
Installing tools: xtensa-esp-elf-gdb, riscv32-esp-elf-gdb, xtensa-esp-elf, riscv32-esp-elf, esp32ulp-elf, cmake, openocd-esp32, ninja, idf-exe, ccache, dfu-util, esp-rom-elfs
Skipping xtensa-esp-elf-gdb@14.2_20240403 (already installed)
Skipping riscv32-esp-elf-gdb@14.2_20240403 (already installed)
Skipping xtensa-esp-elf@esp-14.2.0_20241119 (already installed)
Skipping riscv32-esp-elf@esp-14.2.0_20241119 (already installed)
Skipping esp32ulp-elf@2.38_20240113 (already installed)
Skipping cmake@3.30.2 (already installed)
Skipping openocd-esp32@v0.12.0-esp32-20241016 (already installed)
Skipping ninja@1.12.1 (already installed)
Skipping idf-exe@1.0.3 (already installed)
Installing ccache@4.10.2
Using GitHub assets mirror for URL: https://github.com/ccache/ccache/releas ... x86_64.zip => https://dl.espressif.com/github_assets/ ... x86_64.zip
Downloading https://dl.espressif.com/github_assets/ ... x86_64.zip
Destination: D:\Espressif\dist\ccache-4.10.2-windows-x86_64.zip.tmp
Done
Extracting D:\Espressif\dist\ccache-4.10.2-windows-x86_64.zip to D:\Espressif\tools\ccache\4.10.2



ERROR: Failed to check the tool while installed. Removing directory D:\Espressif\tools\ccache\4.10.2

2025-02-22 13:58:46.029 --------
2025-02-22 13:58:46.029 Message box (OK):
安装过程遇到错误（可能并不严重）。 退出代码： 1
2025-02-22 13:59:00.145 User chose OK.
2025-02-22 13:59:00.155 Message box (Yes/No):
已创建安装日志，其中可能包含有关该问题的详细信息。
是否需要查看安装日志？
2025-02-22 13:59:01.445 User chose Yes.

[georgex]

我也遇到了相同的问题，后面通过更改操作系统语言编码，重启系统后再次安装解决了。具体可参考：https://www.bilibili.com/opus/1032234564296114185
希望对你也有帮助。

[xiaozhi]

我也遇到了同样的问题，在线、离线安装都试了，反复的安装都是这里卡住。 请问楼主你解决了嘛？分享一下解决方案。

[xiaozhi]

找到原因了，电脑的用户名不能有中文，需要用纯英文的用户名