Winget CLI 导致 PowerShell 崩溃问题分析与解决方案

问题现象

在使用 Windows Terminal 时，当系统无法访问 Winget 资源（如无网络连接或资源不可用）的情况下，PowerShell 会突然崩溃并退出。这种情况通常发生在以下场景：

1. 设备没有互联网连接时
2. 在办公和家庭网络之间切换后未完全重启系统
3. Winget 服务暂时不可用时

根本原因

该问题源于 PowerShell 的自动加载机制和 Winget 的 CommandNotFound 模块的交互方式。当系统配置了以下两个关键组件时会出现问题：

1. PowerShell 实验性功能：在 powershell.config.json 中启用了 PSFeedbackProvider 和 PSCommandNotFoundSuggestion 功能
2. 自动加载的 Profile 脚本：Microsoft.PowerShell_profile.ps1 中自动引入了 Microsoft.WinGet.CommandNotFound 模块

当 Winget 服务不可用时，CommandNotFound 模块尝试连接 Winget 目录失败，但错误处理机制不完善，导致未捕获的异常直接终止了 PowerShell 进程。

技术细节分析

从错误堆栈可以看出，问题发生在以下调用链中：

1. PowerShell 启动时自动加载 profile 脚本
2. 脚本执行 Import-Module -Name Microsoft.WinGet.CommandNotFound
3. 模块尝试通过 FinderCommand.GetPackageCatalog() 方法连接 Winget 目录
4. 连接失败抛出 CatalogConnectException
5. 异常未被正确处理，直接导致进程终止

特别值得注意的是，这是一个异步操作中的未处理异常，通过 ThreadPool 最终导致了进程崩溃。

解决方案

临时解决方案

对于需要立即恢复 PowerShell 使用的用户，可以采取以下措施之一：

1. 禁用自动加载：编辑 Microsoft.PowerShell_profile.ps1 文件，注释掉或删除以下内容：

# Import-Module -Name Microsoft.WinGet.CommandNotFound

2. 修改 PowerShell 配置：在 powershell.config.json 中禁用相关实验性功能：

{
    "ExperimentalFeatures": []
}

长期解决方案

等待微软官方修复此问题，建议关注以下改进方向：

1. Winget CommandNotFound 模块应完善错误处理机制
2. PowerShell 应该提供更优雅的模块加载失败处理方式
3. 考虑实现 Winget 服务的本地缓存机制，避免依赖网络连接

最佳实践建议

1. 关键环境配置检查：在自动化脚本中，应先检查 Winget 服务可用性再尝试使用相关功能
2. 错误处理增强：在使用 Winget 相关命令时，应添加 try-catch 块捕获特定异常
3. 模块加载优化：考虑将 Winget 模块的加载改为按需加载，而非在 profile 中自动加载

总结

Winget CLI 作为 Windows 的包管理工具，与 PowerShell 的深度集成带来了便利性，但也引入了稳定性风险。开发者和系统管理员应当了解这种依赖关系可能带来的问题，并采取适当的预防措施。微软团队需要进一步完善错误处理机制，确保在服务不可用时不会影响基础的 PowerShell 功能。