winget-install故障排查手册：resource in use、PowerShell窗口闪退等8个常见坑位与终极解法
【免费下载链接】winget-installInstall WinGet using PowerShell! Prerequisites automatically installed. Works on Windows 10/11 and Server 2019/2022.项目地址: https://gitcode.com/gh_mirrors/wi/winget-install
winget-install 是一个用 PowerShell 编写的一键安装 WinGet 脚本，它能自动检测系统架构、验证兼容性并安装全部前置依赖，支持 Windows 10/11 和 Server 2019/2022。本手册整理安装过程中最高频的 8 个故障——从resource in use、PowerShell 窗口闪退到网络错误——并逐一给出终极解法，帮你快速自救。
故障速查表：30秒定位问题
先对照下表，找到与你症状匹配的那一行，直接跳到对应章节看解法：
| # | 症状 | 原因 | 一句话解法 |
|---|---|---|---|
| 1 | resource in use（0x80073D02） | 终端/PowerShell 占用了 winget 文件 | 加-ForceClose参数重跑 |
| 2 | PowerShell 窗口一闪而过 | 脚本完成后立即退出 | 加-Wait或-NoExit |
| 3 | 提示需要管理员权限 | 未以管理员身份运行 | 右键"以管理员身份运行" |
| 4 | 提示系统版本不受支持 | Win10 低于 1809 / Server 低于 2019 | 升级操作系统 |
| 5 | 无法连接远程服务器 | 网络/DNS 故障或 nuget.org 暂时宕机 | 检查网络后重跑 |
| 6 | 提示"winget 已安装"直接退出 | 系统里已有 winget | 加-Force强制重装 |
| 7 | 前置依赖错误 0x80073CF3 | 依赖包注册不完整 | 重跑，或加-ForceClose |
| 8 | 装完winget命令找不到 | PATH 环境变量未注册 | 用-Force重跑脚本 |
💡 无论遇到哪种问题，先确认三件事：管理员身份、系统版本达标、网络通畅——这是所有解法的前提。
坑位1：resource in use 错误（0x80073D02）
什么症状
运行脚本时弹出警告：
Resources modified are in-use. Try closing Windows Terminal / PowerShell / Command Prompt and try again.为什么会发生
WinGet 本质是一个 AppX 包，而 Windows Terminal、PowerShell、命令提示符等程序恰好"寄生"在它上面。安装/修复 WinGet 时，只要这些程序还在运行并占用相关文件，Windows 就会拒绝写入，报出resource in use。脚本源码中的 Handle-Error 函数会专门识别这个错误码并给出提示。
终极解法
方法一（推荐）：加-ForceClose参数重跑。脚本会自动检测到 Windows Terminal，并在 10 秒后以 conhost.exe 重新启动自身，同时结束所有占用 winget 的进程，整个流程全自动。相关逻辑见 winget-install.ps1。
winget-install -ForceClose方法二（手动）：先手动关闭所有 Windows Terminal、PowerShell、命令提示符窗口，再重新运行脚本。
⚠️ 注意：
-ForceClose会关闭当前 PowerShell 窗口，如果你在同一会话里还挂着其他脚本，请提前保存。
坑位2：PowerShell 窗口闪退、看不清输出
什么症状
脚本明明在跑，但窗口"啪"地一下消失了，你根本没来得及看到结果。
为什么会发生
脚本设计上是完成后立即退出以退出。大多数情况下退出指令只结束脚本、不会关窗，但在个别环境下（尤其是irm ... | iex一行命令方式）PowerShell 会话会跟着一起关闭，窗口瞬间消失。
终极解法
三个参数按需选用：
| 参数 | 效果 |
|---|---|
-Wait | 退出前等待 10 秒，足够你读完输出 |
-NoExit | 完成后无限期暂停，按回车才退出 |
-Debug | 开启调试模式，输出更多细节（可与其他参数叠加） |
winget-install -Wait -Debug如果你必须用一行命令安装，可以把命令包在powershell里运行，例如：
powershell "irm asheroto.com/winget | iex"这样即使内部脚本退出，外层 PowerShell 窗口依然会保留，输出就不会被吞掉。
坑位3：提示需要管理员权限
什么症状
winget requires Administrator privileges to install. Please run the script as an Administrator and try again.为什么会发生
WinGet 需要写入Program Files、注册 AppX 包、修改系统 PATH，这些操作必须拥有管理员权限。脚本启动时会通过 Test-AdminPrivileges 检查当前会话，普通权限会直接拦截。
终极解法
- 开始菜单搜索PowerShell→ 右键 →以管理员身份运行
- 或使用"运行"对话框输入
powershell后按Ctrl+Shift+Enter - 若弹出 UAC 提示，选"是"
坑位4：系统版本不受支持
什么症状
winget requires Windows 10 version 1809 or later on workstations. winget requires Windows Server 2019 or newer on server platforms.兼容性一览
| 系统 | 是否支持 |
|---|---|
| Windows 11 | ✅ 全部支持 |
| Windows 10 | ✅ 仅限 1809 及更高版本 |
| Windows Server 2019/2022/2025 | ✅ 支持（2019 走专用安装路径） |
| Windows Sandbox | ✅ 支持 |
| Server Core（无桌面体验） | 🧪 测试中，可能不稳定 |
| Windows 10 1809 以下 / Server 2016 及以下 | ❌ 不支持 |
终极解法
脚本会逐项核对系统类型与版本号（检查逻辑见 winget-install.ps1）。如果提示版本不支持，只能先通过 Windows Update 升级到达标版本，再运行脚本——这是硬性要求，没有绕过办法。
坑位5：无法连接远程服务器
什么症状
Unable to connect to the remote server或
The remote name could not be resolved为什么会发生
安装过程需要从 nuget.org、GitHub 等服务器下载依赖包和 WinGet 本体。网络不稳、DNS 配置错误，或者 nuget.org 服务器本身短暂宕机（这在 README 的故障排查中被明确提到），都会导致下载失败。
终极解法
- 确认能正常打开任意网页，检查 DNS 是否正常；
- 隔几分钟直接重跑脚本——官方说明"重跑通常就能解决"，因为多半只是服务器暂时抖动；
- 若重跑仍失败，改用备用安装源：
winget-install -AlternateInstallMethod该参数会切换一套独立的下载地址，主源挂掉时往往能成功。如果问题仅出现在本脚本上，可到项目仓库提 issue 反馈。
坑位6：提示"winget 已安装"然后直接退出
什么症状
winget is already installed, exiting... If you want to reinstall winget, run the script with the -Force parameter.为什么会发生
脚本检测到系统中已存在 winget 且能正常工作时，为避免误操作会直接退出。这不是错误，是保护机制（检测逻辑见 winget-install.ps1）。
终极解法
想覆盖重装或升级时，加-Force：
winget-install -Force-Force会无视已安装状态，强制执行完整安装流程。此外还有两个"良性提示"不用慌：看到Higher version already installed或Same version already installed时，脚本只会打印警告并继续，无需处理。
坑位7：前置依赖错误 0x80073CF3
什么症状
Problem with one of the prerequisites.为什么会发生
0x80073CF3 表示某个前置依赖包（如 UI.Xaml、VCLibs）注册不完整或被中断。常见于上一次安装被强制中断、或系统更新刚完成尚未稳定。
终极解法
- 直接重跑一次脚本，多数情况下第二次就能成功；
- 仍失败则加
-ForceClose，借助 conhost 重启与进程清理绕开干扰； - 还不行就加
-Debug输出详细信息，便于定位具体卡在哪个依赖。
坑位8：安装完成但 winget 命令找不到
什么症状
新开一个终端，输入winget却提示"不是内部或外部命令"。
为什么会发生
两种常见原因：一是 PATH 环境变量中的 winget 路径没有注册成功；二是用户名/用户目录含非拉丁字符或路径变更，导致%LOCALAPPDATA%展开出错（该问题在 5.0.7 版本已针对性修复）。
终极解法
用-Force重跑一次脚本，它会重新执行命令注册、修正 PATH 并修复 winget 目录权限：
winget-install -Force跑完后重新打开一个终端窗口（PATH 修改不会作用到已打开的会话），再输入winget验证。
参数速查表：一张图记住所有解法
| 参数 | 用途 | 适用场景 |
|---|---|---|
-ForceClose | 切到 conhost 重启并结束占用进程 | resource in use |
-Force | 无视已安装状态，强制重装 | 已安装退出 / PATH 失效 |
-Wait | 退出前等待 10 秒 | 窗口闪退看不清输出 |
-NoExit | 完成后无限暂停 | 需要慢慢阅读日志 |
-Debug | 输出调试细节 | 一切疑难杂症的第一道排查 |
-AlternateInstallMethod | 切换备用安装源 | 网络/主源失败 |
-CheckForUpdate | 检查脚本是否有新版本 | 定期维护 |
-UpdateSelf | 自动更新脚本到最新版 | 修复后建议升级 |
这些参数也可以写成$Force、$Debug、$ForceClose全局会话变量（设为$true后直接运行winget-install即可），适合放进 PowerShell 配置文件长期使用。
最后的排障建议
- 按
-Debug重跑 → 读日志 → 查错误码的顺序排障，90% 的问题在这一步就能定位； - 若手动安装 WinGet 也失败，说明问题出在 WinGet 本身而非本脚本，可参考官方 WinGet-cli 排障文档；
- 只有"用本脚本才复现"的问题，请到项目仓库提 issue，附上
-Debug的完整输出； - 完整官方排障清单见 README.md 的 Troubleshooting 章节，核心脚本源码为 winget-install.ps1。
🎯 记住这条排障心法：先保权限和网络，再用参数对号入座；
-ForceClose治占用，-Force治残留，-Wait治闪退，-Debug治疑难。
【免费下载链接】winget-installInstall WinGet using PowerShell! Prerequisites automatically installed. Works on Windows 10/11 and Server 2019/2022.项目地址: https://gitcode.com/gh_mirrors/wi/winget-install
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
