PowerShell脚本中计数器在if语句内行为异常问题排查

运行PowerShell脚本生成包含文本及对应图片的Excel文件，其他功能正常，但使用计数器指定图片行时出现异常：if语句外计数器输出正常，if语句内输出的数值间隔极大，重命名计数器变量后问题仍存在。

脚本片段 #

• pictures：文件名列表
• rows_sorted：相机名称列表

foreach ($picture in $pictures) {
    foreach ($row in $rows_sorted) {
        $xlcounter += 1
        Write-Host $xlcounter # 此处计数器输出正常
        if ($picture -match $row ) {
            $live_picture = "C:\Snapshots\pictures\$picture"
            $image = [System.Drawing.Image]::FromFile($live_picture)
            $sheet | Add-ExcelImage -Image $image -Row $xlcounter -Column 4 -ResizeCell
            $image.Dispose()
            Write-Host $xlcounter # 此处计数器输出异常
        }
    }   
}

计数器输出对比 #

• if语句外输出示例：2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
• if语句内输出示例：2 205 408 611 814 1017 1220 1423 1626 1829 2032 2235 2438 2641 2844 3047 3251 3454 3657 3860 4063

问题分析 #

这不是计数器本身的异常，是嵌套循环的逻辑错误：
外层每遍历一个picture，内层就会完整遍历所有rows_sorted，每次内层循环都会执行$xlcounter +=1，导致计数器的增量是rows_sorted的总长度。而if语句只有在picture匹配row时才会输出计数器，两次匹配之间的间隔正好是rows_sorted的长度（比如205-2=203，后续每次间隔都是203），看起来数值异常，实际是逻辑导致的必然结果。

解决方案 #

方案1：仅在插入图片时递增计数器 #

将计数器初始化移到循环外，且只在成功插入图片后递增，避免无意义累加：

$xlcounter = 1 # Excel行号从1开始初始化
foreach ($picture in $pictures) {
    foreach ($row in $rows_sorted) {
        if ($picture -match $row ) {
            $live_picture = "C:\Snapshots\pictures\$picture"
            $image = [System.Drawing.Image]::FromFile($live_picture)
            $sheet | Add-ExcelImage -Image $image -Row $xlcounter -Column 4 -ResizeCell
            $image.Dispose()
            Write-Host $xlcounter # 输出恢复正常
            $xlcounter += 1 # 仅插入后递增计数器
        }
    }   
}

方案2：直接用行列表的索引作为行号 #

如果rows_sorted的顺序和Excel中的行顺序一致，可直接用索引作为行号，完全避免计数器问题：

foreach ($index in 0..($rows_sorted.Count-1)) {
    $row = $rows_sorted[$index]
    # 找到匹配当前行的图片
    $matchingPicture = $pictures | Where-Object { $_ -match $row }
    if ($matchingPicture) {
        $live_picture = "C:\Snapshots\pictures\$matchingPicture"
        $image = [System.Drawing.Image]::FromFile($live_picture)
        # 索引+1对应Excel行号（Excel行从1开始）
        $sheet | Add-ExcelImage -Image $image -Row ($index + 1) -Column 4 -ResizeCell
        $image.Dispose()
    }
}

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