本地配置GitLab CI时GitLab Runner无法识别Git命令的故障排查求助

我来帮你搞定这个问题——我之前在配置Windows环境下的GitLab Runner时也踩过一模一样的坑。咱们先拆解下问题根源，再给你几个靠谱的解决方案：

问题核心原因 #

你看到的'"git"' is not recognized错误，本质是GitLab Runner在拉取代码的初始化阶段（这一步发生在before_script执行之前），找不到Git的可执行文件路径。虽然你在before_script里手动添加了Git的PATH，但这个时机太晚了——Runner要先拉代码才能执行你的脚本，这时候你的环境变量修改还没生效。另外日志里的DEPRECATION: CMD shell is deprecated提示也很关键：CMD模式的环境变量继承性本来就有缺陷，换成PowerShell会减少很多这类问题。

具体解决方案 #

方案1：修改GitLab Runner配置文件，全局注入Git路径 #

这是最稳妥的办法，能让Runner在所有任务启动前就加载正确的环境变量：

• 找到Runner的配置文件：如果是系统级安装，路径是C:\ProgramData\GitLabRunner\config.toml；如果是用户级安装，在你的用户目录下的.gitlab-runner\config.toml。
• 打开文件，找到对应runner1的[[runners]]区块，修改/添加以下配置：

  [[runners]]
    name = "runner1"
    url = "你的GitLab实例地址"
    token = "你的Runner令牌"
    executor = "shell"
    shell = "powershell"  # 替换成PowerShell，规避CMD弃用问题
    environment = ["PATH=$PATH:C:\\Users\\something\\AppData\\Local\\Atlassian\\SourceTree\\git_local\\bin"]
  

• 重启GitLab Runner服务：打开PowerShell/CMD，执行gitlab-runner restart。

方案2：将Git路径添加到系统环境变量 #

如果你的Runner是用系统账户运行的，它可能无法读取你个人用户的环境变量：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
• 在「系统变量」区域找到Path，点击「编辑」，把C:\Users\something\AppData\Local\Atlassian\SourceTree\git_local\bin添加进去，保存所有设置。
• 重启GitLab Runner服务，让新的系统环境变量生效。

方案3：给PowerShell配置全局启动脚本（针对PowerShell执行器） #

如果你已经切换到PowerShell作为执行器，可以通过全局配置文件预加载路径：

• 找到系统级PowerShell配置文件：C:\Windows\System32\WindowsPowerShell\v1.0\profile.ps1（如果不存在就新建一个）。
• 在文件里添加一行：

  $env:Path += ";C:\Users\something\AppData\Local\Atlassian\SourceTree\git_local\bin"
  

• 重启GitLab Runner服务，这样每次Runner启动PowerShell时都会自动加载这个路径。

验证方法 #

修改完成后，你可以手动触发一次流水线，或者在Runner机器上执行gitlab-runner exec shell build-job（本地测试Runner任务），确认Git找不到的错误是否消失。

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