配置ESP-IDF时VS Code误报Git未安装的问题求助

核心原因 #

VS Code启动的终端未正确加载包含Git的系统环境变量，导致执行ESP-IDF的export.bat脚本时无法定位Git程序。而单独运行ESP-IDF时使用的是系统默认终端，环境变量完整，因此不会出现该错误。

具体解决方案 #

1. 验证终端环境变量 #

打开VS Code的命令提示符终端，执行以下命令查看Git路径是否在系统PATH中：

echo %PATH%

如果输出中没有C:\Program Files\Git\cmd（或你的Git实际安装路径），说明终端未加载完整的系统环境变量。

2. 手动注入Git路径到终端 #

修改VS Code工作区配置，在执行export.bat前先将Git路径添加到终端的PATH中：

"Command Prompt": {
    "path": [
        "${env:windir}\\Sysnative\\cmd.exe",
        "${env:windir}\\System32\\cmd.exe"
    ],
    "args": [
        "/k", 
        "set PATH=C:\\Program Files\\Git\\cmd;%PATH% && C:/Espressif/frameworks/esp-idf-v5.0/export.bat"
    ],
    "icon": "terminal-cmd"
}

注意替换C:\\Program Files\\Git\\cmd为你的Git实际安装路径。

3. 切换至Git Bash终端 #

Git Bash自身集成了Git环境，可直接作为默认终端使用：

1. 修改默认终端配置：

"terminal.integrated.defaultProfile.windows": "Git Bash"

2. 打开Git Bash终端后，执行ESP-IDF的初始化脚本：

C:/Espressif/frameworks/esp-idf-v5.0/export.bat

4. 检查VS Code环境变量隔离设置 #

确认VS Code未配置环境变量覆盖项，若存在如下配置请删除：

"terminal.integrated.env.windows": {
    "PATH": "xxx"
}

该配置会替换系统默认PATH，导致Git路径丢失。

内容的提问来源于stack exchange，提问作者Matthieu Kints van