TeamCity中数组参数传递及多构建步骤循环执行问题咨询

我猜你遇到的核心问题是：从步骤1传递到步骤2的CHECKOUT_URL不再是数组，而是变成了逗号分隔的字符串，导致步骤2的FOREACH循环没法正确遍历每个路径。这在TeamCity里是个常见的小坑——因为TeamCity的构建参数本质上都是字符串类型，没法直接传递数组对象。

问题根源拆解 #

当你在步骤1里执行Write-Host "##teamcity[setParameter name='CHECKOUT_URL' value='$checkout']"时，PowerShell会自动把数组$checkout转换成逗号拼接的字符串（比如http://dir1,http://dir2），步骤2拿到的就是这个纯字符串，而非数组结构，自然没法用FOREACH正常遍历每个元素。

分步解决方案 #

步骤1：在构建步骤1中正确序列化数组 #

不要直接传递数组，而是把它转换成可反向解析的字符串格式，推荐两种方式：

# 方法1：JSON序列化（优先推荐，能安全处理含特殊字符的URL）
$checkoutJson = $checkout | ConvertTo-Json -Compress
Write-Host "##teamcity[setParameter name='CHECKOUT_URL' value='$checkoutJson']"

# 方法2：分号分隔（适合URL无分号的简单场景）
$checkoutStr = $checkout -join ";"
Write-Host "##teamcity[setParameter name='CHECKOUT_URL' value='$checkoutStr']"

提示：用JSON的话，-Compress参数能减少换行和空格，避免TeamCity解析时出现引号转义问题。

步骤2：在构建步骤2中反序列化为数组 #

在步骤2的PowerShell脚本开头，把传递过来的字符串重新还原成数组，之后就能正常遍历了：

# 对应方法1的JSON解析
$checkoutArray = $env:CHECKOUT_URL | ConvertFrom-Json

# 对应方法2的分号拆分
$checkoutArray = $env:CHECKOUT_URL -split ";"

# 现在可以正常执行你的遍历逻辑了
foreach ($url in $checkoutArray) {
    # 这里写你的特定算法，比如：
    Write-Host "开始处理路径：$url"
    # 你的业务代码...
}

额外注意事项 #

• 如果你的URL里包含分号，一定要用JSON方法，避免拆分出错
• 确保步骤2的脚本类型是PowerShell，而非Cmd或其他类型，否则环境变量的读取方式会不同
• 可以在步骤2开头加一句Write-Host "收到的CHECKOUT_URL内容：$env:CHECKOUT_URL"，验证参数传递是否正确

内容的提问来源于stack exchange，提问作者Alexey.Ozerov