Windows环境下GitLab CI中Git未被识别的问题排查求助

这种情况我碰到过好几次，核心问题其实是GitLab Runner的运行环境和你手动打开管理员命令行的环境变量不一样，下面给你拆解具体原因和解决办法：

1. Runner默认运行账户的环境变量缺失Git路径 #

GitLab Runner作为Windows服务默认是用Local System账户运行的，这个系统账户的PATH环境变量里并没有包含Git的安装路径；而你手动打开的管理员命令行是用你自己的用户账户启动的，你的账户PATH里已经配置了Git，所以能正常使用。

解决办法：

• 打开Windows服务管理器（可以通过services.msc命令打开）
• 找到GitLab Runner服务，右键选择「属性」
• 切换到「登录」选项卡，选择「此账户」，输入你的管理员账户和密码（就是你手动打开命令行用的那个账户）
• 点击「确定」后重启GitLab Runner服务

2. 在Runner配置中手动指定Git环境变量 #

如果不想修改服务运行账户，也可以直接在Runner的配置文件里添加Git的路径到环境变量：

• 找到Runner的config.toml文件（默认路径一般是C:\GitLab-Runner\config.toml）
• 在[[runners]]区块里添加environment字段，把Git的bin目录路径加进去，比如：

[[runners]]
  name = "你的Runner名称"
  url = "你的GitLab仓库地址"
  token = "你的Runner令牌"
  executor = "shell"
  shell = "powershell"
  # 把Git的路径加到PATH里，注意Windows路径要用双反斜杠
  environment = ["PATH=C:\\Program Files\\Git\\bin;%PATH%"]

• 修改完成后，重启GitLab Runner服务生效

3. 临时解决方案：在流水线脚本中使用Git完整路径 #

如果需要快速验证，也可以在你的流水线脚本里直接写Git的完整执行路径，比如：

build:
  script:
    - 'C:\Program Files\Git\bin\git.exe clone https://你的仓库地址.git'

不过这只是临时办法，还是建议从环境变量层面彻底解决。

4. 验证Runner的环境变量 #

可以在流水线里加一个步骤打印当前的PATH，确认Git路径是否存在：

check-path:
  script:
    - echo $env:PATH  # PowerShell语法
    # 如果是Cmd executor，用 echo %PATH%

运行这个流水线后，查看输出里有没有Git的安装路径，就能明确是不是环境变量的问题。

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