Windows系统GitLab Runner配置问题：pwsh未在PATH中找到

云上老周

2026-7-30

解决Windows上GitLab Runner Shell执行器找不到pwsh的问题

确认PowerShell Core已安装
pwsh是PowerShell Core的可执行文件，并非Windows默认的Windows PowerShell（powershell.exe）。先检查是否安装了PowerShell Core，默认安装路径为C:\Program Files\PowerShell\7\pwsh.exe，若未安装请先完成安装。
检查GitLab Runner的运行身份与系统PATH
GitLab Runner通常以本地系统账户运行，该账户的环境变量PATH可能与你当前登录用户的PATH不共享。即使你配置了用户级PATH，也需要将pwsh的安装路径添加到系统级PATH中。添加完成后，必须重启GitLab Runner服务，让新的PATH配置生效。
手动指定Shell路径（推荐）
直接在GitLab Runner的配置文件config.toml中指定pwsh的绝对路径，避免依赖PATH解析。找到[[runners]]段落，修改shell字段：
```
[[runners]]
  name = "你的Runner名称"
  url = "你的GitLab实例地址"
  token = "你的Runner令牌"
  executor = "shell"
  shell = "C:\\Program Files\\PowerShell\\7\\pwsh.exe"
```
修改后重启GitLab Runner服务。
验证Runner的PATH配置
创建一个简单的流水线任务，输出Runner运行时的PATH，确认是否包含pwsh的路径：
```
verify-path:
  script:
    - echo $env:PATH
```
如果输出中没有pwsh的安装路径，说明Runner未加载到最新的系统PATH，此时优先采用手动指定Shell路径的方案。