GitLab流水线报错‘git未被识别为cmdlet’的解决方法咨询

以下是针对该问题的排查和解决步骤：

1. 确认Git已正确安装在Runner节点上 #

• Windows节点：打开命令提示符，执行git --version，如果提示找不到命令，先下载安装Git，安装时务必勾选“Add Git to PATH”选项（默认一般会选，但要确认）。
• Linux/macOS节点：在终端执行git --version，如果未安装，用包管理器安装，比如Ubuntu/Debian用sudo apt install git，CentOS用sudo yum install git。

2. 验证Path配置的准确性 #

不管是在gitlab-ci.yml还是config.toml中配置Path，必须确保路径是Git实际安装的目录：

• gitlab-ci.yml配置示例：

  variables:
    # Windows系统，注意路径里的反斜杠要转义或用正斜杠
    PATH: "$PATH;C:\\Program Files\\Git\\bin"
    # 或 Linux/macOS系统
    # PATH: "$PATH:/usr/bin/git"
  

• config.toml配置示例：

  [[runners]]
    name = "Your Runner Name"
    url = "https://your-gitlab-instance/"
    token = "your-runner-token"
    executor = "shell"
    # Windows系统
    environment = ["PATH=$PATH;C:\\Program Files\\Git\\bin"]
    # 或 Linux/macOS系统
    # environment = ["PATH=$PATH:/usr/bin/git"]
  

  注意：Windows路径中的反斜杠需要写成双反斜杠转义，避免语法错误。

3. 检查Runner的执行环境 #

若使用Shell Executor #

• Runner是用哪个用户运行的？比如Windows下可能是系统账户（Local System），该用户的环境变量可能未包含Git路径。可以在流水线中添加调试步骤，查看当前环境：

  debug_job:
    script:
      # Windows
      - echo %PATH%
      - where git
      # Linux/macOS
      # - echo $PATH
      # - which git
  

  从输出中确认Git路径是否存在，以及能否定位到git命令。
• 若Runner用系统账户运行，可手动给系统账户添加Git的环境变量，或者切换到普通用户运行Runner。

若使用Docker Executor #

• 默认的基础镜像可能未预装Git，解决方法有两种：
  1. 直接使用带Git的镜像，比如alpine/git、ubuntu（默认带Git）：

     job_with_git:
       image: alpine/git:latest
       script:
         - git --version
     

  2. 在脚本中先安装Git：

     job_with_git:
       image: alpine:latest
       script:
         - apk add --no-cache git
         - git clone your-repo-url
     

4. 修改配置后重启GitLab Runner服务 #

修改config.toml后，必须重启Runner才能让配置生效：

• Windows：打开“服务”面板，找到“GitLab Runner”服务，点击重启。
• Linux：执行sudo gitlab-runner restart。

5. 排查PATH被覆盖的情况 #

确保流水线中没有其他地方将PATH设置为固定值（而非追加）。比如不要写PATH: "C:\\CustomPath"，而应该写PATH: "$PATH;C:\\CustomPath"，保留原有路径的同时追加Git路径，避免覆盖系统默认的PATH。

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