Jenkins执行git config命令报错：无法找到.gitconfig文件

你遇到的这个问题在Windows Jenkins从节点上挺常见的，核心是环境变量解析和运行用户权限的坑，我给你几个针对性的解决方案：

1. 先确认Jenkins的运行用户身份 #

错误里的%USERPROFILE%/.gitconfig找不到，大概率是因为Jenkins服务没以你手动操作的普通用户运行——Windows上Jenkins默认会用本地系统账户启动，它的用户目录是C:\Windows\System32\config\systemprofile，而非你登录的C:\Users\XXX。

你可以先在构建步骤里加一行命令验证：

whoami && echo %USERPROFILE%

看控制台输出就能明确Jenkins当前的运行用户和对应的用户目录。

2. 直接指定.gitconfig的绝对路径 #

不想纠结环境变量的话，直接用绝对路径指定Git配置文件位置，比如已经确认Jenkins运行目录是C:\Windows\System32\config\systemprofile，就改成：

git config --file "C:\Windows\System32\config\systemprofile\.gitconfig" url.https://github.com/.insteadOf git://github.com/

这里不需要加--global，因为已经明确指定了配置文件路径。

3. 把Shell步骤换成Windows批处理步骤 #

Jenkins的Shell步骤在Windows节点上通常调用Git Bash，它对Windows原生环境变量的解析偶尔会出问题。换成执行Windows批处理命令步骤，再运行：

git config --global url.https://github.com/.insteadOf git://github.com/

这样Windows系统会正确解析%USERPROFILE%，而且批处理更适配Windows的权限模型。

4. 改用仓库本地配置替代全局配置 #

如果全局配置一直卡壳，不如直接针对当前构建的仓库做配置——在克隆仓库后，进入仓库目录执行：

cd ${WORKSPACE}/你的仓库名
git config url.https://github.com/.insteadOf git://github.com/

这种方式不需要修改全局配置，也避开了用户目录的权限问题，特别适配Jenkins构建场景。

5. 手动创建配置文件并修复权限 #

如果确认了Jenkins用户目录，但目录里没有.gitconfig文件，可以手动处理：

1. 打开文件管理器，导航到Jenkins用户的目录（比如C:\Windows\System32\config\systemprofile）
2. 新建名为.gitconfig的文件（注意文件名前缀的点）
3. 右键文件→属性→安全，给Jenkins运行用户（比如NT AUTHORITY\SYSTEM）赋予读写权限
4. 重新执行Git配置命令

你可以先从验证Jenkins运行用户开始排查，这是最常见的问题根源。

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