GitLab CI中如何将字符串变量解析为PowerShell哈希表

问题分析 #

GitLab CI会将定义的变量以字符串形式传递给PowerShell，因此直接使用@{}语法定义的哈希表变量，在流水线中只是普通字符串，无法直接作为哈希表对象遍历操作。

解决方案 #

方案1：使用Invoke-Expression解析字符串（快速直接） #

通过Invoke-Expression将字符串形式的PowerShell代码直接执行，转换为实际的哈希表对象。修改.gitlab-ci.yml的script部分：

variables:
  array: '@{"key1" = @("valueA","valueB"); "key2" = @("valueC","valueD")}'

stages:
  - test_stage

test_job:
  stage: test_stage
  script:
    - >
      $array = Invoke-Expression $env:array;
      foreach ($key in $array.Keys){
        foreach ($value in $array[$key]){
          Write-Host "Key: $key , Value: $value"
        }
      }

注意：如果变量内容来自不可信来源，Invoke-Expression存在安全风险，可能执行恶意代码，此时推荐使用更安全的JSON方案。

方案2：改用JSON格式存储变量（更安全） #

将变量内容改为JSON格式，通过ConvertFrom-Json解析为哈希表，避免执行未知代码的风险：

1. 修改变量定义为JSON结构：

variables:
  array_json: '{"key1": ["valueA","valueB"], "key2": ["valueC","valueD"]}'

2. 更新流水线脚本解析JSON：

test_job:
  stage: test_stage
  script:
    - >
      # PowerShell 7+ 直接使用 -AsHashtable 参数
      $array = $env:array_json | ConvertFrom-Json -AsHashtable;
      foreach ($key in $array.Keys){
        foreach ($value in $array[$key]){
          Write-Host "Key: $key , Value: $value"
        }
      }

如果使用PowerShell 5.x（不支持-AsHashtable），可以通过以下方式转换：

$psObj = $env:array_json | ConvertFrom-Json;
$array = @{};
foreach ($prop in $psObj.PSObject.Properties) {
    $array[$prop.Name] = $prop.Value;
}

验证效果 #

两种方案执行后，均会输出预期结果：

Key: key1 , Value: valueA
Key: key1 , Value: valueB
Key: key2 , Value: valueC
Key: key2 , Value: valueD

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