本文解决了 ESP-IDF 在 Windows 上安装时卡在子模块更新的问题。原因是 Espressif 自带的 idf-git 工具包中的 sed 命令在 Windows 10 下调用出错。解决方案是将 ESP-IDF 目录下的 idf-git 替换为系统已安装的 Git（通过符号链接 mklink）。步骤包括确认路径、备份原文件、创建符号链接并验证版本，最后重新运行安装脚本。
今天安装 esp-idf-tools-setup-offline-5.4.2.exe 的时候，卡在'完成 esp-idf 安装，在子模块中更新'阶段。
Running command: D:\soft\esp_idf\ins\Espressif\tools\idf-git\2.44.0\cmd\git.exe -C D:\soft\esp_idf\ins\Espressif\frameworks\esp-idf-v5.4.2 submodule foreach --recursive git config --local core.fileMode false
Espressif 自带的 idf-git（实际上是一个封装的 Git + MSYS2 工具包）在 Windows10 上调用 sed 出错，导致卡在 submodule foreach。解决思路是用系统里安装的 Git 替换掉 ESP-IDF 自带的 idf-git。
打开命令行（Win + R → 输入 cmd → 回车），输入以下命令查看当前系统 Git 路径：
where git
确保结果为：
C:\Program Files\Git\cmd\git.exe
找到 ESP-IDF 目录下的 git.exe，右键重命名为 git_old.exe 以便恢复。
路径示例：
D:\soft\esp_idf\ins\Espressif\tools\idf-git\2.44.0\cmd\
mklink "D:\soft\esp_idf\ins\Espressif\tools\idf-git\2.44.0\cmd\git.exe" "C:\Program Files\Git\cmd\git.exe"
如果成功，会显示'符号链接已创建'。这一步让 ESP-IDF 目录下的 git.exe 实际上指向系统 Git。
在 CMD 中执行：
"D:\soft\esp_idf\ins\Espressif\tools\idf-git\2.44.0\cmd\git.exe" --version
如果显示系统 Git 的版本（如 2.50.1.windows.1），说明替换成功。
现在再运行 install.bat，它会继续使用 idf-git 路径，但实际上调用的是系统 Git，不会再触发 sed: read error on stdin: Bad file descriptor 错误。
mklink，否则会提示权限不足。idf-git，你需要重复一次上述步骤。ESP-IDF 安装器通常将脚本放在指定安装目录下。根据日志，你的安装路径是：
D:\soft\esp_idf\ins\Espressif\
常见路径如下：
D:\soft\esp_idf\ins\Espressif\esp-idf\install.bat
D:\soft\esp_idf\ins\Espressif\frameworks\esp-idf-v5.4.2\install.bat
进入对应目录后，执行 install.bat 即可继续安装。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online