PowerShell 7中ForEach-Parallel进度条显示异常问题

问题根源很明确：Write-Progress是依赖主线程控制台的单线程更新机制，而ForEach-Parallel是多线程执行，多个线程同时调用Write-Progress会触发并发竞争——控制台没法同时处理多个进度更新请求，就算你同步了完成数，每个线程单独发起的更新也会互相干扰，导致进度条显示混乱（比如跳0%、4%这种错误值）。

给你两个可行的解决思路：

思路1：主线程单独负责进度更新（推荐） #

把进度条的刷新逻辑移到主线程，让主线程定期读取同步哈希表的完成数，统一更新进度条，避免多线程直接操作控制台。

示例代码：

# 初始化同步哈希表统计进度
$syncStats = [hashtable]::Synchronized(@{
    Completed = 0
    Total     = $downloadItems.Count # 你的下载任务总数
})

# 启动并行下载任务
$parallelJobs = $downloadItems | ForEach-Object -Parallel {
    $stats = $using:syncStats
    # 执行你的下载逻辑
    # 比如：Invoke-WebRequest -Uri $_.Url -OutFile $_.Path
    
    # 任务完成后更新计数（同步操作，不会有冲突）
    $stats.Completed++
} -ThrottleLimit 8 # 根据你的环境调整并发数

# 主线程循环更新进度条
while ($parallelJobs.State -contains 'Running') {
    $currentPercent = [math]::Round(($syncStats.Completed / $syncStats.Total) * 100)
    Write-Progress -Activity "批量下载任务" `
                   -Status "已完成 $($syncStats.Completed)/$($syncStats.Total)" `
                   -PercentComplete $currentPercent
    Start-Sleep -Milliseconds 300 # 控制刷新频率，避免过度占用资源
}

# 任务全部完成后，收尾进度条
Write-Progress -Activity "批量下载任务" -Status "全部完成" -PercentComplete 100 -Completed

思路2：给Write-Progress加线程锁 #

如果一定要在并行线程里触发进度更新，得用锁确保同一时间只有一个线程能调用Write-Progress，避免并发冲突。但这种方式会稍微影响并行性能，因为线程需要等待锁释放。

示例代码片段（放在并行任务的更新环节）：

$stats = $using:syncStats
$lockObj = $using:syncStats # 用同步哈希表本身当锁对象

# 任务完成后更新计数并刷新进度
[System.Threading.Monitor]::Enter($lockObj)
try {
    $stats.Completed++
    $currentPercent = [math]::Round(($stats.Completed / $stats.Total) * 100)
    Write-Progress -Activity "批量下载任务" `
                   -Status "已完成 $($stats.Completed)/$($stats.Total)" `
                   -PercentComplete $currentPercent
}
finally {
    [System.Threading.Monitor]::Exit($lockObj)
}

总结一下：优先用思路1，让主线程统一处理进度更新，既避免了并发问题，也不会影响并行任务的执行效率。

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