winget-cli：Windows 包管理器客户端源码

效率工具 26.6k（+3） 1.8k C++ 2026-11-15 访问官网 ↗ 在 GitHub 打开

Windows Package Manager（winget）客户端的源码仓库，用于从命令行发现、安装和管理软件包。

winget-cli 是 Windows Package Manager（winget）客户端的源码仓库，客户端通过 `winget install` 等命令发现并安装软件包。客户端围绕“源”组织包元数据：默认 `winget` 源指向社区仓库，`msstore` 源指向 Microsoft Store，也支持自建基于 REST 的私有源。客户端随 App Installer 通过 Microsoft Store 分发，也可从 Releases 获取开发版；要求 Windows 10 1809（build 17763）、Windows 11 或 Windows Server 2025 及以上，因依赖 IsWow64Process2 和 MSIX 无法运行于 Windows Server Core 或更早版本。仓库还包含 Microsoft.WinGet.Client PowerShell 模块。README 说明管理员与非管理员运行时安装提权行为不同，并提供自行构建客户端的开发者指引。

Star 趋势2026-11-08 — 2026-11-15当前 Stars 27k24h +3

#command-line #package-manager #windows #winget

项目信息

所有者: microsoft
Star: 26.6k
Fork: 1.8k
开源协议: —
主要语言: C++
发布时间: 2019-07-16
最近更新: 2026-11-13

项目更新

Windows Package Manager 1.29.3802026-09-21
winget v1.29 是一次服务性更新，核心变化是新增了实验性的来源优先级功能（sourcePriority，默认关闭）。可在添加来源时或用 source edit 给来源指定数值，优先级高的来源排在列表前面；搜索结果的排序依据依次是匹配质量、匹配字段、来源顺序，因此它能轻微影响结果次序。实际收益更明显的是 install 这类面向可用包的命令：若多个来源都返回结果但只有一个来源优先级最高且只给出一条结果，就直接采用它，不再弹「找到多个包」的报错，CLI 和 PowerShell 模块均已生效。同时 REST 来源（如 msstore）的结果会正确填写匹配条件，避免被自动排到最前。小改动包括：winget export 会记录安装时用过的 --override 与 --custom 参数，winget import 时自动重放，重装无需手工补齐；新增 --no-progress 开关，屏蔽进度条和转圈动画，优先级高于 visual.progressBar 配置，适合脚本与自动化环境；MCP 服务的 find-winget-packages 增加 upgradeable 参数、install-winget-package 增加 upgradeOnly 参数，让 AI 代理能查可升级包、执行仅升级操作；PowerShell 模块现在会读取 GHTOKEN 或 GITHUBTOKEN 环境变量来认证 GitHub API 请求。
Windows Package Manager 1.30.140-preview预发布2026-09-11
Windows 包管理器 v1.30 推出一个新旗标：install 命令新增 --ignore-unavailable，一次安装多个包时，若个别包在已配置源中找不到，不再整体报错，而是跳过继续装其余包——此前只有 import 命令支持该行为。修复方面：winget search --id <msstoreId> 现在不必额外加 --exact 也能正确返回商店包；开启 Resume 实验特性并配合 --disable-interactive 安装时的崩溃（0x8000ffff）已解决；以根路径为基准的相对路径处理也做了修正。另将 NUnit 升级至 v4。
Windows Package Manager 1.29.2902026-08-24
Windows Package Manager v1.29 是维护版本，却带来了几处实用改进。最核心的是源优先级（sourcePriority，实验性，默认关闭）：添加或编辑源时可赋数值，优先级高的源在列表中靠前，其他条件相同时搜索结果也优先展示。配合这一改动，install 会优先采用高优先级源返回的唯一结果，减少「找到多个包」的歧义提示；REST 源（如 msstore）的结果现在也正确填写影响排序的匹配条件，不再被自动顶到最前。其余更新：winget export 会记录安装时用过的 --override、--custom 参数，import 重装时自动套用；新增 --no-progress 开关，屏蔽进度条与转圈输出，便于自动化脚本；MCP 的 find-winget-packages 与 install-winget-package 分别新增 upgradeable、upgradeOnly 参数，支持「升级」类请求；PowerShell 模块会读取 GHTOKEN 或 GITHUBTOKEN 环境变量来认证 GitHub API。
Windows Package Manager 1.30.100-preview预发布2026-08-13
这是 WinGet 的 v1.30 预览版，主要更新：install 命令新增 --ignore-unavailable 标志——批量安装时若部分包在已配置源中找不到，装完其余包后照常结束，不再整体报错，补齐了此前只有 import --ignore-unavailable 才有的行为。另外修复了在开启 Resume 实验特性时配合 --disable-interactivity 安装会崩溃（0x8000ffff）的问题，并把测试框架 NUnit 升级到 v4。项目仍在预览阶段，遇到问题可提交 issue 反馈。
Windows Package Manager 1.30.90-preview预发布2026-08-06
WinGet v1.30.90 预览版发布，这是面向尝鲜用户的预览构建，可能仍存在未发现的问题，遇到异常可在仓库提 issue。本版没有新增功能，主要在修问题：一是修复开启 Resume 实验特性后，安装时使用 --disable-interactivity 会崩溃（错误码 0x8000ffff）的故障；二是禁止管理员权限卸载用户级软件包，避免越权操作；三是 IndexCreationTool 会把子进程的报错透传出来，方便排查索引创建失败的原因。依赖方面，测试框架升级到 NUnit v4，日志查看工具的几个前端依赖也做了小幅更新。
Windows Package Manager 1.30.80-preview预发布2026-07-29
WinGet v1.30.80 预览版发布，本版没有新功能，主要是修复问题。安装过程中若开启 Resume 实验特性并使用 --disable-interactivity 参数，会触发 0x8000ffff 崩溃，现已修复。另外为微软商店源（msstore）安装新增了一个可选遥测事件，用于记录商店目录的安装情况；测试框架升级到 NUnit v4，并顺带修正了 NuGet 包路径、便携应用测试等问题。这是预览构建，可能存在未发现的缺陷，遇到问题欢迎到 issue 区反馈。
Windows Package Manager 1.30.70-preview预发布2026-07-22
WinGet v1.30 预览版发布。本次实际改动不多：安装过程中若同时启用 --disable-interactivity 参数与 Resume 实验特性，会触发 0x8000ffff 崩溃，现已修复；另修正了配置（configuration）标准流程下的提权校验问题，此前校验结果可能不准确。其余更新属于内部维护——清理旧的商店测试证书、统一仓库行尾与编辑器配置、修复构建报错、修正错误信息标点，并升级了日志查看工具 WinGetLogViewer 的若干依赖。新特性方面暂无内容。预览版可能存在未发现的缺陷，遇到问题可到官方仓库提交 issue。
Windows Package Manager 1.30.50-preview预发布2026-07-17
WinGet v1.30.50-preview 是面向尝鲜用户的预览构建，本次没有新增功能，主要修了个崩溃问题：安装过程中同时开启 Resume 实验特性并使用 --disable-interactivity，会抛出 0x8000ffff 导致进程退出，现已修复。另外还调整了配置流程中标准权限下的 elevation 校验逻辑，并顺手修正了错误提示里的标点。除此之外多为仓库内部维护：统一换行符与 .gitattributes 配置、清理 vcpkg 构建残留、修复 cpprest 的 checked iterator 编译报错，日志查看工具升级了几项前端依赖。预览版仍可能有 bug，遇到问题可到官方 issue 区反馈。完整变更见 https://github.com/microsoft/winget-cli/compare/v1.29.240...v1.30.50-preview
Windows Package Manager 1.29.2802026-06-24
Windows Package Manager v1.29 主打源优先级（实验性，sourcePriority，默认关闭）：添加源时或事后用 source edit 可赋数值优先级，高的排前，其他条件相同时结果也跟着靠前。搜索排序本就依次看匹配质量、匹配字段、源顺序，这下第三层更好干预了。更实用的是，install 遇到多源返回结果时，只要最高优先级只落在一个源且它只返回一条，就直接采用，不再报「找到多个包」，CLI 与 PowerShell 模块均已生效；REST 源（如 msstore）也会正确标注匹配条件，不再自动霸榜。其余更新：winget export 会记下安装时的 --override、--custom，import 重装时自动套用；新增 --no-progress 关闭进度条与转圈，便于自动化；MCP 工具新增 upgradeable、upgradeOnly 参数，可查询与执行升级；PowerShell 模块读取 GHTOKEN 或 GITHUBTOKEN 认证 GitHub API 请求。
Windows Package Manager 1.29.250预发布2026-06-05
winget v1.29 发行候选版，主打「源优先级」：用 sourcePriority（实验性，默认关闭）为源打分，优先级高的源排序靠前，并会优先采用其唯一结果，减少「找到多个包」的反复提示；REST 源（如 msstore）的匹配标准同步修正，不再总被顶到最前。其他改进：winget export 会记录安装时的 --override 与 --custom，import 时自动复用，重装不必再手工补参数；新增 --no-progress 旗标，屏蔽进度条与转圈输出，适合脚本和自动化场景；MCP 服务端的 find-winget-packages 增加 upgradeable、install-winget-package 增加 upgradeOnly，AI 助手据此可查询并执行升级；PowerShell 模块会自动读取 GHTOKEN 或 GITHUBTOKEN 认证 GitHub API。发现问题欢迎提交 issue。