2026/9/20 17:27:30
FEATURED · 精选文章 
第一次在同事的屏幕上看到一长串软件被安排得明明白白那种感觉挺微妙同一台电脑他装完系统后靠几条命令就把常用软件全部搞定而我还在一个个打开浏览器、搜索官网、下载安装包、点下一步。这个工具就是 WinGet微软官方出品的 Windows 包管理器。简单说它是一个命令行版的“软件安装管家”你给出软件名字它负责把下载、校验、安装、升级一整套流程跑完。这篇博客从 WinGet 的下载安装开始讲把日常使用、镜像源配置、常见报错排查全部梳理一遍Windows 用户和开发者都适合收藏一份。1. WinGet 到底是什么把“装软件”从手工劳动变成一条命令1.1 从“装软件”这件小事说起在 Windows 上装软件的历史经历过好几个阶段。早年是买光盘、塞光驱后来是百度搜官网、下载安装包、一路下一步再有就是各类“软件管家”全家桶。用官网安装包的问题是第一来源不统一机器上装了哪些软件、什么版本、是否安全全凭记忆时间一长很容易装出重复软件和垃圾残留第二升级是灾难今天想更新一个软件得重新走一遍“找官网、下安装包、确认版本”的流程第三批量部署基本靠人肉新来的同事配一台开发机光装环境就得折腾半小时。如果你用过 Linux 的 apt 或者 macOS 的 Homebrew会非常清楚包管理器解决的就是这三个痛点统一的软件来源、统一的升级通道、统一的卸载清理。WinGet 就是微软给 Windows 补上的这块拼图。它由微软官方开发和维护软件包仓库叫 winget-pkgs社区贡献者维护了成千上万个软件包的安装清单里面有 7-Zip、VLC、PowerToys、Python、Node.js、Git 这类常见软件也有大量专业工具和开源项目。1.2 和“软件管家”相比WinGet 赢在哪很多人会问我直接用某某软件管家不也一样吗不一样而且差别很大。下面这张表是我自己对比过几个常见方案后整理出来的对比项传统软件管家官网手动下载WinGet软件来源自家商店收录可能夹带推广官网需要自行判断社区维护的开放仓库 winget-pkgs安装过程客户端界面引导部分版本有捆绑手动点击向导命令行自动下载安装可全静默更新管理仅自家收录的软件可更新无法统一管理一条命令升级全部软件批量部署不支持纯手工支持 export/import 配置文件是否依赖 GUI是是否可脚本化适合远程和 CI说句公道话软件管家对小白用户友好图形界面点点点就能安装。但它的局限性也很明显收录不透明、偶尔夹带推广、升级覆盖不全。WinGet 的模型更像“软件的 Git”仓库是开放的安装清单有版本信息命令是确定的特别适合需要可复现环境的场景比如开发机初始化、测试环境搭建、公司统一装机。它的门槛是你要愿意开一个终端但说实话这个门槛真的不高本文后面每一步都会给出可以直接复制执行的命令。2. 拿到手的第一步WinGet 下载安装与版本核验2.1 先检查系统里有没有 WinGetWinGet 并不是一个独立下载的 exe而是集成在“应用安装程序App Installer”这个系统组件里。Windows 11 和较新版本的 Windows 101809 以上通常自带这个组件但很多精简版系统、企业定制镜像或长期没更新的系统可能没有预装或者版本太老。最直接的检查方式打开 PowerShell或 Windows Terminal输入下面这行命令winget --version如果输出类似v1.9.x这样的版本号说明已经可用了。如果提示“无法将‘winget’项识别为 cmdlet、函数、脚本文件或可运行程序的名称”说明系统里没有这个组件或者应用执行别名被关闭了。还有一种情况是命令存在但版本很老建议更新到新版本因为老版本对源协议、安装参数的支持都不够完善后面配置镜像源时也容易出问题。2.2 常规在线安装方式从 Microsoft Store 更新 App Installer最简单的安装方式就是打开 Microsoft Store搜索“应用安装程序”或“App Installer”点击更新或安装。商店里这个应用就是 WinGet 的宿主微软会把 WinGet 的更新随着商店版本一起推送。另外留意一下系统设置里的“应用执行别名”。在 Windows 10/11 的设置里搜索“应用执行别名”确保winget和winget.exe两个开关都是打开的。有些安全软件或系统优化工具会顺手关掉这里的别名导致命令不存在其实是误伤。这个开关的原理很简单它把winget命令指向商店安装的 App Installer 程序入口关闭了就等于剥夺了命令行的访问路径。如果你用的是 LTSC 这类不带商店的版本或者商店被组策略禁用那就走离线安装路线见下一节。2.3 离线安装版本没有商店也能装“缺少 winget”这个问题在很多内网服务器上特别常见。解决思路是下载 App Installer 的离线安装包然后用 PowerShell 直接部署。具体分两步先拿到安装包。WinGet 的发布渠道是 GitHub 的 microsoft/winget-cli 仓库在 Releases 页面找到最新版本下载Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle文件同时下载同名的.xml文件。注意 msixbundle 里有不同架构的包建议选择 x64 架构的版本即可如果你的机器是 arm64 可以选对应架构。拿到文件后用管理员身份打开 PowerShell切换到文件所在目录执行Add-AppxPackage -Path .\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle这里有一个容易踩的坑如果系统缺少必要的依赖包比如 VCLibs、UI.XamlAdd-AppxPackage 会报错提示找不到依赖。解决办法是同时下载发布的.xml中列出的依赖包并添加-DependencyPath参数。具体命令为Add-AppxPackage -Path .\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle -DependencyPath .\Microsoft.VCLibs.140.00.UWPDesktop_14.0.30704.0_x64__8wekyb3d8bbwe.msix安装完成后重新打开终端执行winget --version验证。整个过程不依赖图形安装向导特别适合服务器和离线网络环境这也是很多运维同事最喜欢的部署方式一条命令就完成核心组件的落地。3. 核心实战用 winget 安装、卸载、升级软件3.1 装第一个软件从搜索到安装的完整路径先别急着敲winget install确认软件包 ID 是关键一步。拿 7-Zip 举例打开终端输入winget search 7zip输出结果里会列出名称、ID、来源和匹配程度。正常情况下你会看到7-Zip.7zip这就是这个软件包的唯一标识。包 ID 的命名规则一般是“发布者.软件名”比如 Google.Chrome、Mozilla.Firefox、Python.Python.3.12。看到 ID 后可以先看看它的详细信息winget show 7-Zip.7zip这一步会显示软件的版本、安装程序类型、发布者、许可协议等在不确定一个包是否可靠时非常有用。确认无误后执行安装winget install 7-Zip.7zipWinGet 会创建下载任务验证哈希然后调用安装程序完成安装。大多数软件支持静默安装参数你甚至看不到安装窗口。如果你的环境需要完全无人值守可以加上几个参数winget install 7-Zip.7zip --silent --accept-package-agreements --accept-source-agreements--silent让安装程序不弹界面--accept-package-agreements自动接受软件许可协议--accept-source-agreements自动接受源协议。这三件套在写脚本批量部署时几乎是标配建议随身记着。3.2 升级和卸载别再用“控制面板”了WinGet 的升级能力是它最值钱的功能之一。手动检查更新是一件反人性的事而upgrade子命令把这变成了例行公事。先看系统里有哪些软件可升级winget upgrade输出会列出已安装、有新版本的软件包列表。全部升一遍winget upgrade --all如果只想升级某个软件直接指定包 IDwinget upgrade Google.Chrome。这里有两个细节值得注意第一upgrade --all执行时会逐个安装中间某个软件如果安装程序要求关闭当前运行中的进程会导致升级失败所以升级前最好先保存工作并关闭明显占用中的程序第二不是所有软件包都支持静默升级少数安装程序会强制弹出交互界面这类软件只能手动处理。卸载同样简单不再需要去“设置 - 应用”里一页页翻找winget uninstall 7-Zip.7zipwinget list可以查看系统当前通过 WinGet 安装的所有包winget list这条命令输出的列表比控制面板的应用列表更纯粹它会标注每个软件的 ID 和版本号配合升级功能用起来非常顺手。3.3 批量部署把“配环境”变成一条命令批量安装是 WinGet 真正拉开差距的场景。新电脑、新虚拟机、公司新员工的开发机以前要装 Chrome、微信、VS Code、Git、Python、Node.js每一样都要单独下载执行现在可以写成一个脚本直接跑。无非就是把安装命令一行行堆进去winget install --silent --accept-package-agreements --accept-source-agreements Google.Chrome winget install --silent --accept-package-agreements --accept-source-agreements Tencent.WeChat winget install --silent --accept-package-agreements --accept-source-agreements Microsoft.VisualStudioCode winget install --silent --accept-package-agreements --accept-source-agreements Git.Git winget install --silent --accept-package-agreements --accept-source-agreements Python.Python.3.12更优雅的做法是使用配置文件。在一台已经装好各种软件的机器上执行winget export -o .\packages.json得到一份 JSON 文件里面记录了所有已安装的软件包 ID、版本范围和来源。然后在新机器上执行winget import -i .\packages.json --accept-package-agreements --accept-source-agreementsWinGet 会逐条读取配置并自动安装缺失的软件。配合 Git 仓库管理这份配置文件整个团队的环境基准就能保持基本一致。我个人会在每次重装系统后先跑一遍 import再去处理那些仓库里没有收录的“漏网之鱼”整个过程从半天缩短到一顿饭的工夫。4. 走镜像源解决下载慢、反复失败的进阶操作4.1 为什么默认源会“翻车”WinGet 默认的软件源指向微软官方的 CDN存放的是软件包的元数据信息安装时实际下载的安装包来自各软件官方渠道。在国内网络环境下这个默认源偶尔会出现连接超时、源更新失败、安装中途中断的情况。典型表现是命令敲下去后卡在Updating source或者Downloading阶段半天不动最后抛出一个网络错误。这不是 WinGet 本身的问题而是网络链路的问题。解决方案是切换到一个更稳定、更快的镜像源。目前比较常用的是国内高校开源镜像站提供的 WinGet 源镜像比如中科大开源软件镜像站。需要说明的是镜像源镜像的是 WinGet 仓库的元数据安装包本体依然从软件官网下载所以在“找得到软件包”这一环提速、提稳效果非常明显。4.2 中科大 WinGet 源配置步骤配置镜像源并不复杂核心就是“移除旧源、添加新源”两个动作。先查看当前源列表winget source list你会看到一个名为winget的源地址指向微软官方。接下来用中科大镜像替换它。Windows PowerShell 里执行winget source remove winget然后添加中科大源。地址是https://mirrors.ustc.edu.cn/winget-source/对应的命令是winget source add winget https://mirrors.ustc.edu.cn/winget-source/注意这里我仍然使用了winget作为源名称这样原有命令无需改动所有不带--source参数的搜索和安装操作都会自动走新源。如果你不想覆盖旧源也可以保留默认源用一个新的名字添加winget source add ustc https://mirrors.ustc.edu.cn/winget-source/然后安装时显式指定源winget install 7-Zip.7zip --source ustc这种方式适合那些想“默认源为主、镜像源为辅”的用户可以在特定软件包走官方源失败时切换尝试。配置完成后建议执行一次源更新让本地缓存刷新winget source update4.3 源管理、优先级与恢复默认源多了以后需要知道怎么管理和切换。几个常用的源管理命令winget source list # 列出所有源 winget source update # 更新所有源缓存 winget source reset winget --force # 强制恢复指定源的默认地址如果你按上面第二种种方式保留了多个源而默认源偶尔抽风可以把镜像源的优先级调高。WinGet 的源优先级通过winget source add时的--priority参数设置数字越小优先级越高winget source add ustc https://mirrors.ustc.edu.cn/winget-source/ --priority 1如果把源配置坏了或者想回到官方默认状态执行winget source reset --force这会清空所有自定义源恢复默认。注意--force参数会直接重置不需要二次确认使用前想清楚。说实话配置源这件事在实际使用中“一次配好、长期受益”但很多教程喜欢把命令说得玄乎其实核心就是增删查改掌握了上面几条换任何镜像站都只是换个 URL 的事。5. 常见问题与排查技巧实录报错别再乱删系统了5.1 高频错误速查表这一节整理了我在日常使用和帮同事排查时遇到的典型问题直接做成表格方便你对照处理错误现象可能原因解决方法winget不是内部或外部命令系统未安装 App Installer或执行别名被关闭在线安装/离线部署 App Installer检查应用执行别名无法找到程序包/No package found matching input criteria包 ID 写错或源缓存未更新先用winget search确认 ID再执行winget source updatewinget : 无法...后跟一串路径命令执行不完整通常是包名被终端解析错误检查包 ID 是否包含空格/特殊字符用引号包裹参数Failed in attempting to update the source源连接超时或证书问题切换镜像源或执行winget source reset安装程序失败退出代码: 1603安装程序要求管理员权限或磁盘空间不足用管理员身份打开终端重试清理 C 盘空间0x80070005/ 访问被拒绝权限不足使用管理员 PowerShell 执行下载卡住不动默认源连接到官方 CDN 不稳定配置中科大源观察下载地址依赖项不满足离线安装 App Installer 时缺少运行库补齐 VCLibs 等依赖包后用-DependencyPath参数安装很多报错本质上就两个原因一个是包名不对一个是权限不够。先搜、再看、再装这个顺序不要乱。遇到“无法”类错误我强烈建议把完整错误信息复制到搜索引擎比盯着终端里那一行中文猜半天有效得多。5.2 一个典型报错场景的完整排查过程网上经常看到有人贴出类似这样的命令记录PS C:\Users\Administrator winget install anthropic.claudecode winget : 无法...“无法”后面往往跟着一串描述但没贴完整导致很多人没法判断具体原因。我把这种报错的排查路径走一遍你以后遇到也能照做。第一步确认报错的完整文本。只看到“无法”两个字不够要看它说的是“无法找到程序包”还是“无法解析依赖”还是“无法连接到源”。这决定了问题方向。第二步如果是“无法找到程序包”先执行winget search claudecode确认包 ID 是否真的存在。像个别较新或较冷门的软件可能还没有被 winget-pkgs 仓库收录这时候只能走官网手动安装。第三步如果搜索到了但安装失败看是不是版本冲突。可以尝试指定版本安装winget install --id anthropic.claudecode --version 1.0.0 --force--force参数会跳过一些校验但要注意它同时也会跳过部分安全检查不建议作为日常参数使用。第四步检查是否被代理设置或网络策略阻断。企业内网经常有网络白名单导致安装包下载失败这时可以先ping一下下载地址或者干脆尝试配置镜像源再试一次。5.3 几个值得养成的使用习惯最后分享几个让我效率明显提升的使用习惯都是平时用出来的经验新手可以直接抄。第一每周或每两周跑一次winget upgrade --all。别等到某个软件坏了才想起来升级把升级当作例行维护能少踩很多已知问题的坑。升级前有未保存的工作先保存一下避免安装程序要求重启应用时打断工作。第二别只记install一条命令search和show是帮你“看清再动手”的关键。新软件先搜索确认开源项目和包 ID 是否是预期的那一个再用show看看安装来源是不是官方地址。社区仓库虽然相对可靠但多看一眼不亏。第三管理好你的源。源不是越多越好我发现很多人喜欢把几个镜像源都加上结果搜索时返回一堆重复条目安装时反而出现包来源冲突。建议只保留一个默认源加一个备用镜像源装不上了再手动切。第四善用settings命令。winget settings可以打开 WinGet 的配置文件里面有一些高级选项比如启用实验特性、自定义安装行为等。日常用不到但知道入口在哪里将来需要时能省不少找资料的时间。第五脚本化部署时记得把--accept-package-agreements和--accept-source-agreements写上。否则在无人值守场景下WinGet 会停下来等用户确认协议整个脚本就卡住了。写在最后这几年 Windows 在开发者体验上的进步WinGet 算是比较有代表性的一个。它和 PowerShell、Windows Terminal、WSL 配合起来把很多以前靠手动点击才能完成的操作逐渐变成了可记录、可复用、可分享的脚本。我自己的使用体会是真正让我离不开它的不是安装那一下的方便而是“升级所有软件”和“重装系统后一键恢复环境”这两个能力。第一次用winget upgrade --all把十几个软件一次性更新完的时候确实有种前所未有的爽快感。如果你还在一个个手动装软件建议从今天起遇到任何想安装的工具先敲一句winget search慢慢就会习惯这种“能用命令行解决就不点鼠标”的节奏。
WinGet完全指南：Windows包管理器安装、配置镜像源与排查技巧
第一次在同事的屏幕上看到一长串软件被安排得明明白白那种感觉挺微妙同一台电脑他装完系统后靠几条命令就把常用软件全部搞定而我还在一个个打开浏览器、搜索官网、下载安装包、点下一步。这个工具就是 WinGet微软官方出品的 Windows 包管理器。简单说它是一个命令行版的“软件安装管家”你给出软件名字它负责把下载、校验、安装、升级一整套流程跑完。这篇博客从 WinGet 的下载安装开始讲把日常使用、镜像源配置、常见报错排查全部梳理一遍Windows 用户和开发者都适合收藏一份。1. WinGet 到底是什么把“装软件”从手工劳动变成一条命令1.1 从“装软件”这件小事说起在 Windows 上装软件的历史经历过好几个阶段。早年是买光盘、塞光驱后来是百度搜官网、下载安装包、一路下一步再有就是各类“软件管家”全家桶。用官网安装包的问题是第一来源不统一机器上装了哪些软件、什么版本、是否安全全凭记忆时间一长很容易装出重复软件和垃圾残留第二升级是灾难今天想更新一个软件得重新走一遍“找官网、下安装包、确认版本”的流程第三批量部署基本靠人肉新来的同事配一台开发机光装环境就得折腾半小时。如果你用过 Linux 的 apt 或者 macOS 的 Homebrew会非常清楚包管理器解决的就是这三个痛点统一的软件来源、统一的升级通道、统一的卸载清理。WinGet 就是微软给 Windows 补上的这块拼图。它由微软官方开发和维护软件包仓库叫 winget-pkgs社区贡献者维护了成千上万个软件包的安装清单里面有 7-Zip、VLC、PowerToys、Python、Node.js、Git 这类常见软件也有大量专业工具和开源项目。1.2 和“软件管家”相比WinGet 赢在哪很多人会问我直接用某某软件管家不也一样吗不一样而且差别很大。下面这张表是我自己对比过几个常见方案后整理出来的对比项传统软件管家官网手动下载WinGet软件来源自家商店收录可能夹带推广官网需要自行判断社区维护的开放仓库 winget-pkgs安装过程客户端界面引导部分版本有捆绑手动点击向导命令行自动下载安装可全静默更新管理仅自家收录的软件可更新无法统一管理一条命令升级全部软件批量部署不支持纯手工支持 export/import 配置文件是否依赖 GUI是是否可脚本化适合远程和 CI说句公道话软件管家对小白用户友好图形界面点点点就能安装。但它的局限性也很明显收录不透明、偶尔夹带推广、升级覆盖不全。WinGet 的模型更像“软件的 Git”仓库是开放的安装清单有版本信息命令是确定的特别适合需要可复现环境的场景比如开发机初始化、测试环境搭建、公司统一装机。它的门槛是你要愿意开一个终端但说实话这个门槛真的不高本文后面每一步都会给出可以直接复制执行的命令。2. 拿到手的第一步WinGet 下载安装与版本核验2.1 先检查系统里有没有 WinGetWinGet 并不是一个独立下载的 exe而是集成在“应用安装程序App Installer”这个系统组件里。Windows 11 和较新版本的 Windows 101809 以上通常自带这个组件但很多精简版系统、企业定制镜像或长期没更新的系统可能没有预装或者版本太老。最直接的检查方式打开 PowerShell或 Windows Terminal输入下面这行命令winget --version如果输出类似v1.9.x这样的版本号说明已经可用了。如果提示“无法将‘winget’项识别为 cmdlet、函数、脚本文件或可运行程序的名称”说明系统里没有这个组件或者应用执行别名被关闭了。还有一种情况是命令存在但版本很老建议更新到新版本因为老版本对源协议、安装参数的支持都不够完善后面配置镜像源时也容易出问题。2.2 常规在线安装方式从 Microsoft Store 更新 App Installer最简单的安装方式就是打开 Microsoft Store搜索“应用安装程序”或“App Installer”点击更新或安装。商店里这个应用就是 WinGet 的宿主微软会把 WinGet 的更新随着商店版本一起推送。另外留意一下系统设置里的“应用执行别名”。在 Windows 10/11 的设置里搜索“应用执行别名”确保winget和winget.exe两个开关都是打开的。有些安全软件或系统优化工具会顺手关掉这里的别名导致命令不存在其实是误伤。这个开关的原理很简单它把winget命令指向商店安装的 App Installer 程序入口关闭了就等于剥夺了命令行的访问路径。如果你用的是 LTSC 这类不带商店的版本或者商店被组策略禁用那就走离线安装路线见下一节。2.3 离线安装版本没有商店也能装“缺少 winget”这个问题在很多内网服务器上特别常见。解决思路是下载 App Installer 的离线安装包然后用 PowerShell 直接部署。具体分两步先拿到安装包。WinGet 的发布渠道是 GitHub 的 microsoft/winget-cli 仓库在 Releases 页面找到最新版本下载Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle文件同时下载同名的.xml文件。注意 msixbundle 里有不同架构的包建议选择 x64 架构的版本即可如果你的机器是 arm64 可以选对应架构。拿到文件后用管理员身份打开 PowerShell切换到文件所在目录执行Add-AppxPackage -Path .\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle这里有一个容易踩的坑如果系统缺少必要的依赖包比如 VCLibs、UI.XamlAdd-AppxPackage 会报错提示找不到依赖。解决办法是同时下载发布的.xml中列出的依赖包并添加-DependencyPath参数。具体命令为Add-AppxPackage -Path .\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle -DependencyPath .\Microsoft.VCLibs.140.00.UWPDesktop_14.0.30704.0_x64__8wekyb3d8bbwe.msix安装完成后重新打开终端执行winget --version验证。整个过程不依赖图形安装向导特别适合服务器和离线网络环境这也是很多运维同事最喜欢的部署方式一条命令就完成核心组件的落地。3. 核心实战用 winget 安装、卸载、升级软件3.1 装第一个软件从搜索到安装的完整路径先别急着敲winget install确认软件包 ID 是关键一步。拿 7-Zip 举例打开终端输入winget search 7zip输出结果里会列出名称、ID、来源和匹配程度。正常情况下你会看到7-Zip.7zip这就是这个软件包的唯一标识。包 ID 的命名规则一般是“发布者.软件名”比如 Google.Chrome、Mozilla.Firefox、Python.Python.3.12。看到 ID 后可以先看看它的详细信息winget show 7-Zip.7zip这一步会显示软件的版本、安装程序类型、发布者、许可协议等在不确定一个包是否可靠时非常有用。确认无误后执行安装winget install 7-Zip.7zipWinGet 会创建下载任务验证哈希然后调用安装程序完成安装。大多数软件支持静默安装参数你甚至看不到安装窗口。如果你的环境需要完全无人值守可以加上几个参数winget install 7-Zip.7zip --silent --accept-package-agreements --accept-source-agreements--silent让安装程序不弹界面--accept-package-agreements自动接受软件许可协议--accept-source-agreements自动接受源协议。这三件套在写脚本批量部署时几乎是标配建议随身记着。3.2 升级和卸载别再用“控制面板”了WinGet 的升级能力是它最值钱的功能之一。手动检查更新是一件反人性的事而upgrade子命令把这变成了例行公事。先看系统里有哪些软件可升级winget upgrade输出会列出已安装、有新版本的软件包列表。全部升一遍winget upgrade --all如果只想升级某个软件直接指定包 IDwinget upgrade Google.Chrome。这里有两个细节值得注意第一upgrade --all执行时会逐个安装中间某个软件如果安装程序要求关闭当前运行中的进程会导致升级失败所以升级前最好先保存工作并关闭明显占用中的程序第二不是所有软件包都支持静默升级少数安装程序会强制弹出交互界面这类软件只能手动处理。卸载同样简单不再需要去“设置 - 应用”里一页页翻找winget uninstall 7-Zip.7zipwinget list可以查看系统当前通过 WinGet 安装的所有包winget list这条命令输出的列表比控制面板的应用列表更纯粹它会标注每个软件的 ID 和版本号配合升级功能用起来非常顺手。3.3 批量部署把“配环境”变成一条命令批量安装是 WinGet 真正拉开差距的场景。新电脑、新虚拟机、公司新员工的开发机以前要装 Chrome、微信、VS Code、Git、Python、Node.js每一样都要单独下载执行现在可以写成一个脚本直接跑。无非就是把安装命令一行行堆进去winget install --silent --accept-package-agreements --accept-source-agreements Google.Chrome winget install --silent --accept-package-agreements --accept-source-agreements Tencent.WeChat winget install --silent --accept-package-agreements --accept-source-agreements Microsoft.VisualStudioCode winget install --silent --accept-package-agreements --accept-source-agreements Git.Git winget install --silent --accept-package-agreements --accept-source-agreements Python.Python.3.12更优雅的做法是使用配置文件。在一台已经装好各种软件的机器上执行winget export -o .\packages.json得到一份 JSON 文件里面记录了所有已安装的软件包 ID、版本范围和来源。然后在新机器上执行winget import -i .\packages.json --accept-package-agreements --accept-source-agreementsWinGet 会逐条读取配置并自动安装缺失的软件。配合 Git 仓库管理这份配置文件整个团队的环境基准就能保持基本一致。我个人会在每次重装系统后先跑一遍 import再去处理那些仓库里没有收录的“漏网之鱼”整个过程从半天缩短到一顿饭的工夫。4. 走镜像源解决下载慢、反复失败的进阶操作4.1 为什么默认源会“翻车”WinGet 默认的软件源指向微软官方的 CDN存放的是软件包的元数据信息安装时实际下载的安装包来自各软件官方渠道。在国内网络环境下这个默认源偶尔会出现连接超时、源更新失败、安装中途中断的情况。典型表现是命令敲下去后卡在Updating source或者Downloading阶段半天不动最后抛出一个网络错误。这不是 WinGet 本身的问题而是网络链路的问题。解决方案是切换到一个更稳定、更快的镜像源。目前比较常用的是国内高校开源镜像站提供的 WinGet 源镜像比如中科大开源软件镜像站。需要说明的是镜像源镜像的是 WinGet 仓库的元数据安装包本体依然从软件官网下载所以在“找得到软件包”这一环提速、提稳效果非常明显。4.2 中科大 WinGet 源配置步骤配置镜像源并不复杂核心就是“移除旧源、添加新源”两个动作。先查看当前源列表winget source list你会看到一个名为winget的源地址指向微软官方。接下来用中科大镜像替换它。Windows PowerShell 里执行winget source remove winget然后添加中科大源。地址是https://mirrors.ustc.edu.cn/winget-source/对应的命令是winget source add winget https://mirrors.ustc.edu.cn/winget-source/注意这里我仍然使用了winget作为源名称这样原有命令无需改动所有不带--source参数的搜索和安装操作都会自动走新源。如果你不想覆盖旧源也可以保留默认源用一个新的名字添加winget source add ustc https://mirrors.ustc.edu.cn/winget-source/然后安装时显式指定源winget install 7-Zip.7zip --source ustc这种方式适合那些想“默认源为主、镜像源为辅”的用户可以在特定软件包走官方源失败时切换尝试。配置完成后建议执行一次源更新让本地缓存刷新winget source update4.3 源管理、优先级与恢复默认源多了以后需要知道怎么管理和切换。几个常用的源管理命令winget source list # 列出所有源 winget source update # 更新所有源缓存 winget source reset winget --force # 强制恢复指定源的默认地址如果你按上面第二种种方式保留了多个源而默认源偶尔抽风可以把镜像源的优先级调高。WinGet 的源优先级通过winget source add时的--priority参数设置数字越小优先级越高winget source add ustc https://mirrors.ustc.edu.cn/winget-source/ --priority 1如果把源配置坏了或者想回到官方默认状态执行winget source reset --force这会清空所有自定义源恢复默认。注意--force参数会直接重置不需要二次确认使用前想清楚。说实话配置源这件事在实际使用中“一次配好、长期受益”但很多教程喜欢把命令说得玄乎其实核心就是增删查改掌握了上面几条换任何镜像站都只是换个 URL 的事。5. 常见问题与排查技巧实录报错别再乱删系统了5.1 高频错误速查表这一节整理了我在日常使用和帮同事排查时遇到的典型问题直接做成表格方便你对照处理错误现象可能原因解决方法winget不是内部或外部命令系统未安装 App Installer或执行别名被关闭在线安装/离线部署 App Installer检查应用执行别名无法找到程序包/No package found matching input criteria包 ID 写错或源缓存未更新先用winget search确认 ID再执行winget source updatewinget : 无法...后跟一串路径命令执行不完整通常是包名被终端解析错误检查包 ID 是否包含空格/特殊字符用引号包裹参数Failed in attempting to update the source源连接超时或证书问题切换镜像源或执行winget source reset安装程序失败退出代码: 1603安装程序要求管理员权限或磁盘空间不足用管理员身份打开终端重试清理 C 盘空间0x80070005/ 访问被拒绝权限不足使用管理员 PowerShell 执行下载卡住不动默认源连接到官方 CDN 不稳定配置中科大源观察下载地址依赖项不满足离线安装 App Installer 时缺少运行库补齐 VCLibs 等依赖包后用-DependencyPath参数安装很多报错本质上就两个原因一个是包名不对一个是权限不够。先搜、再看、再装这个顺序不要乱。遇到“无法”类错误我强烈建议把完整错误信息复制到搜索引擎比盯着终端里那一行中文猜半天有效得多。5.2 一个典型报错场景的完整排查过程网上经常看到有人贴出类似这样的命令记录PS C:\Users\Administrator winget install anthropic.claudecode winget : 无法...“无法”后面往往跟着一串描述但没贴完整导致很多人没法判断具体原因。我把这种报错的排查路径走一遍你以后遇到也能照做。第一步确认报错的完整文本。只看到“无法”两个字不够要看它说的是“无法找到程序包”还是“无法解析依赖”还是“无法连接到源”。这决定了问题方向。第二步如果是“无法找到程序包”先执行winget search claudecode确认包 ID 是否真的存在。像个别较新或较冷门的软件可能还没有被 winget-pkgs 仓库收录这时候只能走官网手动安装。第三步如果搜索到了但安装失败看是不是版本冲突。可以尝试指定版本安装winget install --id anthropic.claudecode --version 1.0.0 --force--force参数会跳过一些校验但要注意它同时也会跳过部分安全检查不建议作为日常参数使用。第四步检查是否被代理设置或网络策略阻断。企业内网经常有网络白名单导致安装包下载失败这时可以先ping一下下载地址或者干脆尝试配置镜像源再试一次。5.3 几个值得养成的使用习惯最后分享几个让我效率明显提升的使用习惯都是平时用出来的经验新手可以直接抄。第一每周或每两周跑一次winget upgrade --all。别等到某个软件坏了才想起来升级把升级当作例行维护能少踩很多已知问题的坑。升级前有未保存的工作先保存一下避免安装程序要求重启应用时打断工作。第二别只记install一条命令search和show是帮你“看清再动手”的关键。新软件先搜索确认开源项目和包 ID 是否是预期的那一个再用show看看安装来源是不是官方地址。社区仓库虽然相对可靠但多看一眼不亏。第三管理好你的源。源不是越多越好我发现很多人喜欢把几个镜像源都加上结果搜索时返回一堆重复条目安装时反而出现包来源冲突。建议只保留一个默认源加一个备用镜像源装不上了再手动切。第四善用settings命令。winget settings可以打开 WinGet 的配置文件里面有一些高级选项比如启用实验特性、自定义安装行为等。日常用不到但知道入口在哪里将来需要时能省不少找资料的时间。第五脚本化部署时记得把--accept-package-agreements和--accept-source-agreements写上。否则在无人值守场景下WinGet 会停下来等用户确认协议整个脚本就卡住了。写在最后这几年 Windows 在开发者体验上的进步WinGet 算是比较有代表性的一个。它和 PowerShell、Windows Terminal、WSL 配合起来把很多以前靠手动点击才能完成的操作逐渐变成了可记录、可复用、可分享的脚本。我自己的使用体会是真正让我离不开它的不是安装那一下的方便而是“升级所有软件”和“重装系统后一键恢复环境”这两个能力。第一次用winget upgrade --all把十几个软件一次性更新完的时候确实有种前所未有的爽快感。如果你还在一个个手动装软件建议从今天起遇到任何想安装的工具先敲一句winget search慢慢就会习惯这种“能用命令行解决就不点鼠标”的节奏。 
