使用 WinGet源命令可以管理源。 使用 源 命令，可以 添加、 列出、 更新、 删除、 重置或 导出 WinGet 源。
WinGet 源提供用于发现和安装应用程序的数据。 仅使用安全受信任的源。
WinGet 指定以下三个默认源，可以使用它列出 winget source list。
- msstore - Microsoft Store 目录。
- winget - 应用程序的 WinGet 社区存储库。
- winget-font - 用于字体的 WinGet 社区存储库。
用法
winget source <subcommand> <options>
Sub-Commands
可使用以下参数。
| Sub-Command | 说明 |
|---|---|
| 添加 | 添加一个新源。 |
| 列表 | 列出当前源。 |
| 更新 | 更新当前源。 |
| 删除 | 删除当前源。 |
| 重置 | 重置默认源 msstore、winget 和 winget-font。 |
| 导出 | 导出当前源。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| -?、--help | 显示有关所选命令的帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
添加
add 子命令用于添加新源。 此子命令需要 --name 和 --arg 选项。 由于该命令会更改用户访问权限，因此使用 add 需要管理员权限。
用法：
winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -n、--name | 用于标识源的名称。 |
| -a、--arg | 源的 URL 或 UNC。 |
| -t、--type | 源的类型。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| --trust-level | 源的信任级别（无或受信任）。 |
| --header | 可选 Windows-Package-Manager REST 源 HTTP 标头。 |
| --accept-source-agreements | 用于接受源许可协议，并避免出现提示。 |
| --明确 | |
| -?、--help | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
例如，winget source add --name Contoso https://www.contoso.com/cache 在 URL https://www.contoso.com/cache 处添加 Contoso 存储库。
可选类型参数
add 子命令支持可选的 type 参数，该参数用于告知客户端将要连接到的存储库类型。 支持以下类型。
| 类型 | 说明 |
|---|---|
| Microsoft.PreIndexed.Package | 默认源类型。 |
| Microsoft.Rest | Microsoft REST API 源。 |
列表
list 子命令枚举当前启用的来源，或提供有关特定源的详细信息。
注释
当源设置为显式时，它必须专门面向它。 默认情况下，winget 字体源设置为显式。 这意味着任何其他 WinGet 命令都必须使用“--source winget-font”或“-s winget-font”直接引用源。
用法：
winget source list [[-n] <name>] [<options>]
别名
以下别名可用于此子命令：
- LS
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -n、--name | 用于标识源的名称。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| -?、--help | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
全部列出
列表子命令本身winget source list提供配置源的完整列表：
Name Argument Explicit
------------------------------------------------------------------
msstore https://storeedgefd.dsx.mp.microsoft.com/v9.0 false
winget https://cdn.winget.microsoft.com/cache false
winget-font https://cdn.winget.microsoft.com/fonts true
列出源详细信息
要获取有关源的完整详细信息，请传入源的名称。 例如：
winget source list --name winget
返回以下输出：
Field Value
--------------------------------------------------
Name winget
Type Microsoft.PreIndexed.Package
Argument https://cdn.winget.microsoft.com/cache
Data Microsoft.Winget.Source_8wekyb3d8bbwe
Identifier Microsoft.Winget.Source_8wekyb3d8bbwe
Trust Level Trusted|StoreOrigin
Explicit false
Updated 2025-12-11 08:30:25.000
-
Name是源的名称。 -
Type是源的类型。 -
Arg是源使用的 URL 或路径。 -
Data是可选的包名称（如果适用）。 -
Updated是上次更新源的日期和时间。
更新
update 子命令用于强制更新单个源或所有源。
用法：
winget source update [[-n] <name>] [<options>]
别名
以下别名可用于此子命令：
- 刷新
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -n、--name | 用于标识源的名称。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| -?、--help | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
全部更新
update 子命令本身 请求对所有存储库进行更新。
更新源
带有 --name 选项的 update 子命令用于将更新定向到指定的源。 例如：winget source update --name Contoso 强制更新 Contoso 存储库。
删除
remove 子命令用于删除源。 此子命令需要 --name 选项才能标识源。 由于该命令会更改用户访问权限，因此使用 remove 需要管理员权限。
用法：
winget source remove [-n] <name> [<options>]
别名
以下别名可用于此子命令：
- 马币
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -n、--name | 用于标识源的名称。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| -?、--help | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
示例
winget source remove --name Contoso
此命令将移除 Contoso 存储库。
复位/重设/还原
reset 子命令用于将客户端重置为其原始配置，并删除除默认源之外的所有源。 仅在极少数情况下才会使用此子命令。 由于该命令会更改用户访问权限，因此使用 reset 需要管理员权限。
由于 reset 命令会删除所有源，因此必须使用 --force 选项强制执行该操作。
用法：
winget source reset [[-n] <name>] [<options>]
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -n、--name | 用于标识源的名称。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| --力 | 强制重置源。 |
| -?、--help | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
导出
export 子命令用于将源的特定详细信息导出到 JSON 输出。 这对于配置源代码管理的组策略非常有用。
用法：
winget source export [[-n] <name>] [<options>]
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -n、--name | 用于标识源的名称。 |
选项
可以使用以下选项。
| 选项 | 说明 |
|---|---|
| -?、--help | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn,--ignore-warnings | 禁止警告输出。 |
| --禁用互动性 | 禁用交互式提示。 |
| --代理 | 设置要用于此执行的代理。 |
| --无代理 | 禁用此执行使用代理。 |
示例
winget source export winget
返回以下输出：
{"Arg":"https://cdn.winget.microsoft.com/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Explicit":false,"Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","TrustLevel":["Trusted","StoreOrigin"],"Type":"Microsoft.PreIndexed.Package"}
源协议
单个 源 可以请求用户在添加或使用源之前同意提供的协议。 如果用户不接受协议，WinGet 将无法访问源。
可以使用 --accept-source-agreements 选项接受源协议并避免出现提示。
许多 WinGet 命令评估所有配置的源。 如果任何配置的源需要协议，则 WinGet 会在使用这些源之前提示。 在使用之前必须接受源协议。 如果源更新协议条款，或者如果删除并读取了源（如所示 winget source reset --force），则会再次显示协议。
