GitLab CI：如何在Windows运行器中使用Bash Shell

我来帮你排查Windows上GitLab Runner用Bash执行脚本的问题，结合官方文档和实际踩坑经验，给你几个可行的解决方向：

1. 明确指定Bash的完整路径 #

Windows上的Bash通常由Git Bash提供，默认情况下Runner可能无法正确识别bash这个命令的位置。你需要在config.toml中指定Bash的完整安装路径：

找到Git Bash的安装目录（通常是C:\Program Files\Git\bin\bash.exe或C:\Program Files\Git\usr\bin\bash.exe），然后修改Runner配置：

[[runners]]
name = "myTestRunner"
url = "xxxxxxxxxxxxxxxxxxx"
token = "xxxxxxxxxxxxxxxx"
executor = "shell"
# 使用双反斜杠转义路径，或者用正斜杠
shell = "C:\\Program Files\\Git\\bin\\bash.exe"

修改后记得重启GitLab Runner服务生效。

2. 验证Bash环境是否正常加载 #

有时候Runner的执行上下文没有加载Git Bash的完整环境变量，导致$PWD这类Bash内置变量无法正常解析。你可以在CI脚本中先初始化Git Bash的环境：

stages:
  - Stage1
testJob:
  stage: Stage1
  when: always
  script:
    # 加载Git Bash的环境配置
    - source "C:/Program Files/Git/etc/profile.d/git-prompt.sh"
    - echo $PWD
  tags:
    - myTestRunner

3. 手动验证Bash执行环境 #

先在Runner所在的Windows机器上，手动打开Git Bash执行echo $PWD，确认命令本身能正常输出当前路径。如果手动执行正常但CI执行异常：

• 尝试重启GitLab Runner服务（管理员权限打开PowerShell执行）：

  Restart-Service gitlab-runner
  

• 检查Runner是否以正确的用户身份运行（比如是否是安装Git Bash的用户），权限不足也可能导致环境加载异常。

4. 排查脚本语法与Bash版本兼容性 #

在CI脚本中添加版本检查，确认Runner使用的Bash版本：

script:
  - bash --version
  - echo $PWD

如果版本过低，考虑升级Git Bash到最新稳定版，避免语法兼容问题。

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