终端中PromptForChoice激活时进度条不可见的问题排查与解决

为什么进度条会消失？ #

$Host.UI.PromptForChoice 是直接调用PowerShell主机底层UI交互接口的方法，它会临时独占控制台的输出缓冲区——显示选择弹窗时会清除或覆盖当前控制台的所有临时输出（包括Write-Progress生成的进度条）。同时，在交互选择过程中，PowerShell的进度渲染线程会被暂停，直到用户提交选择，这就是为什么只有提交第一个选择后进度条会短暂闪现：那是PowerShell重新渲染了一次进度条，但下一次调用PromptForChoice时又会被覆盖。

解决办法 #

方法1：自定义选择菜单替代$Host.UI.PromptForChoice #

用Read-Host配合自定义文本菜单实现选择功能，不会触发主机UI的独占接管，进度条可以保持显示。示例代码：

$progressCount = 0
$totalItems = $junctionPoints.Count

foreach ($point in $junctionPoints) {
    $progressCount++
    # 更新进度条
    Write-Progress -Activity "创建OneDrive连接点" -Status "处理第 $progressCount/$totalItems 个项目" -PercentComplete ($progressCount/$totalItems*100)

    # 自定义选择提示
    Write-Host "`n是否创建连接点: $($point.Target) -> $($point.Path)?"
    Write-Host "1) 是"
    Write-Host "2) 否"
    $choice = Read-Host "请输入选择(1/2)"

    switch ($choice) {
        "1" {
            # 执行创建连接点的逻辑
            New-Item -ItemType Junction -Path $point.Path -Target $point.Target -Force
            Write-Host "已创建连接点: $($point.Path)"
        }
        "2" {
            Write-Host "跳过连接点: $($point.Path)"
        }
        default {
            Write-Host "无效选择，跳过此项目"
        }
    }
}

方法2：每次选择后重新写入进度条 #

如果一定要用$Host.UI.PromptForChoice，可以在用户提交选择后再次调用Write-Progress重新渲染进度条。这种方法仍会在弹窗时丢失进度条，但提交后会立刻恢复：

$progressCount = 0
$totalItems = $junctionPoints.Count
$title = "创建OneDrive连接点"
$message = "是否创建此连接点？"
$options = @(
    [System.Management.Automation.Host.ChoiceDescription]::new("&是"),
    [System.Management.Automation.Host.ChoiceDescription]::new("&否")
)

foreach ($point in $junctionPoints) {
    $progressCount++
    $status = "处理第 $progressCount/$totalItems 个项目"
    # 先写入进度条
    Write-Progress -Activity $title -Status $status -PercentComplete ($progressCount/$totalItems*100)

    # 调用PromptForChoice
    $choice = $Host.UI.PromptForChoice($title, "$message`n目标: $($point.Target)`n路径: $($point.Path)", $options, 0)

    # 提交选择后重新写入进度条
    Write-Progress -Activity $title -Status $status -PercentComplete ($progressCount/$totalItems*100)

    if ($choice -eq 0) {
        New-Item -ItemType Junction -Path $point.Path -Target $point.Target -Force
        Write-Host "已创建连接点: $($point.Path)"
    } else {
        Write-Host "跳过连接点: $($point.Path)"
    }
}

方法3：异步进度提示（进阶） #

如果需要更流畅的体验，可以结合PowerShell后台作业或Runspace实现异步进度更新，让进度条在后台线程持续渲染，不受前台交互影响。但这种方法复杂度较高，需要注意线程安全问题，适合对体验要求较高的场景。

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