PowerShell计时循环随机挂起无法完成，按键捕获超时逻辑未生效

问题根因 #

• Windows 控制台默认开启快速编辑模式，当用户误触鼠标点击/拖选控制台内容时，控制台会进入选择挂起状态，$host.UI.RawUI.KeyAvailable这类宿主级输入查询接口会被完全阻塞，直到用户取消选择（按ESC或右键点击控制台），这就是计数随机停止、程序永不超时的核心原因。
• 非原生控制台宿主（如PowerShell ISE）没有完整实现RawUI接口的异步查询能力，也会触发该类阻塞问题。

修复后的代码 #

function get-mycommand{
    $count=0
    $sleepTimer=2 #单位：毫秒
    # 临时禁用控制台快速编辑模式，避免选择模式阻塞
    try {
        $mode = $host.UI.RawUI.WindowSelectionMode
        $host.UI.RawUI.WindowSelectionMode = $false
    } catch {
        # 低版本PowerShell不支持该属性时直接跳过
        $mode = $null
    }

    try {
        while ($count -le 100)
        {
            # 改用.NET底层Console类的KeyAvailable，不受宿主接口阻塞影响
            if([System.Console]::KeyAvailable) {
                $key = $host.UI.RawUI.ReadKey('NoEcho, IncludeKeyDown')
                return $key.Character
            } else {
                $count++
                Write-Host $count
                Start-Sleep -Milliseconds $sleepTimer
            }
        }
        return "fail"
    }
    finally {
        # 恢复原有控制台设置
        if ($null -ne $mode) {
            $host.UI.RawUI.WindowSelectionMode = $mode
        }
    }
}

function test-get-command{
    $myvalue = get-mycommand
    Write-Host  'return ' $myvalue
}

修复说明 #

• 替换$host.UI.RawUI.KeyAvailable为[System.Console]::KeyAvailable，底层.NET实现不依赖宿主UI接口，不会被控制台选择模式阻塞，无按键时会正常计数直到超时。
• 新增控制台选择模式的临时禁用逻辑，执行完毕自动恢复原有设置，彻底避免用户误操作导致的程序挂起，低版本PowerShell不支持该属性时会自动跳过该逻辑不影响运行。
• 兼容原生PowerShell控制台、Windows Terminal等主流宿主，修改后无按键时会在200ms后正常返回fail字符串，原有按键捕获逻辑不受影响。

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