Win11下VS Code Git GUI突然改用%USERPROFILE%下.gitconfig的问题

问题背景 #

Win11系统，此前Git与VS Code配合正常：设置了%HOME%环境变量，全局.gitconfig（含用户名、邮箱）存放在该路径下，终端、VS Code内置终端及VS Code GUI均能正常调用Git配置。

近期突发异常：VS Code GUI提交代码时提示用户名和邮箱缺失，但终端（包括VS Code内置终端）操作Git完全正常。排查发现VS Code GUI当前默认读取%USERPROFILE%路径下的.gitconfig，而非%HOME%路径下的原有配置。

疑问解答 #

1. 为何出现这种情况？ #

VS Code的Git GUI模块并非完全直接调用系统git.exe执行操作，它有独立的配置读取逻辑，触发原因可能包括：

• VS Code Git插件更新：新版本插件调整了配置文件查找优先级，优先读取Windows默认的%USERPROFILE%路径，而非%HOME%环境变量指定路径
• 环境变量生效范围变更：系统更新或软件安装过程中，%HOME%变量的生效范围被修改，导致VS Code GUI进程未正确加载该变量（终端进程通常会继承完整环境变量）
• VS Code运行方式变化：比如以管理员身份启动时，环境变量读取逻辑与普通用户模式存在差异

2. 如何改回原配置？ #

以下是按优先级排序的可行方案：

方案一：强制VS Code指定全局Git配置文件

1. 打开VS Code，按下Ctrl+,（或Cmd+,）进入设置界面
2. 搜索git.path，确认VS Code使用的是终端中正常工作的git.exe路径（保证与终端Git版本一致）
3. 搜索git.config，找到Git: Config Path选项，点击编辑 in settings.json
4. 在settings.json中添加配置（替换为你的%HOME%实际路径）：

"git.configPath": "D:\\YourHomePath\\.gitconfig"

方案二：确保VS Code加载完整%HOME%环境变量

• 关闭所有VS Code窗口，通过系统CMD或PowerShell输入code命令启动VS Code，此时进程会继承终端的完整环境变量（包括%HOME%）
• 若使用快捷方式启动，右键快捷方式→属性→快捷方式，确认目标栏无特殊参数，且“起始位置”为用户目录或空白

方案三：在%USERPROFILE%添加配置引用

在%USERPROFILE%路径下新建.gitconfig文件，内容为引用原有配置：

[include]
    path = %HOME%/.gitconfig

这样VS Code GUI读取%USERPROFILE%配置时，会自动加载%HOME%下的原配置

临时方案说明 #

• 将%HOME%设为%USERPROFILE%并移动配置：会改变Git全局配置默认存储路径，不符合需求，不推荐
• 关闭Require Git User Config：仅绕过VS Code的配置检查，未解决根本问题，可能引发后续Git异常，不建议长期使用

内容的提问来源于stack exchange，提问作者17tmh