使用 WinGet 工具來安裝和管理應用程式

WinGet 是命令行工具，可讓使用者探索、安裝、升級、移除及設定 Windows 10、Windows 11 和 Windows Server 2025 電腦上的應用程式。 此工具是 Windows 封裝管理員服務的用戶端介面。

安裝 WinGet

WinGet Windows 封裝管理員 可在 Windows 11、新式版本的 Windows 10 和 Windows Server 2025 上作為應用程式安裝程式的一部分使用。 應用程式 安裝程式 是由 Windows 桌面版本上的Microsoft存放區傳遞和更新的系統元件，以及透過 Windows Server 2025 上的更新來傳遞和更新。

安裝 WinGet 預覽版本 [僅限開發人員]

WinGet 包含在 Windows 應用程式安裝程式中。 若要嘗試最新的 Windows Package Manager 功能，您可以使用下列其中一種方式來安裝預覽組建：

• 下載最新的 WinGet 預覽版本。 閱讀 WinGet 預覽的版本資訊，以瞭解任何新功能。 安裝此套件會為您提供 WinGet 用戶端的預覽版本，但不會啟用從 Microsoft Store 自動更新新預覽版本的功能。

• 使用 Microsoft 帳戶 (MSA)、公司、學校或 Azure Active Directory (AAD) 帳戶來註冊 Windows Insider Dev Channel。 Windows Insider Dev Channel 包含從 Microsoft Store 自動更新新預覽版本的功能。

• 使用 Microsoft 帳戶 (MSA) 來註冊 Windows Package Manager Insiders Program。 新增您的 Microsoft 帳戶 (MSA) 後 (收到電子郵件通知後的幾天)，您將從 Microsoft Store 收到新預覽版本的自動更新。

在 Windows 沙箱上安裝 WinGet

Windows 沙箱提供了一個輕量型桌面環境，可以安全地隔離執行應用程式。 安裝在 Windows 沙箱環境內的軟體會保持「沙箱化」，並與主機電腦分開執行。 Windows 沙箱不包含 WinGet，也不包含 Microsoft Store 應用程式，因此您必須從 GitHub 上的 WinGet 版本頁面下載最新的 WinGet 套件。

若要在 Windows 沙箱上安裝穩定的 WinGet 版本，請從 Windows PowerShell 命令提示字元中照著下列步驟執行：

$progressPreference = 'silentlyContinue'
Write-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager
Write-Host "Done."

若要在計算機範圍內安裝 PowerShell 模組，您可以使用 -Scope AllUsers 參數搭配 Install-Module Cmdlet。 如果您想要預覽版本的 WinGet，您可以使用 Repair-WinGetPackageManager Cmdlet 來新增 -IncludePrerelease 參數。 若要查看 Repair-WinGetPackageManager Cmdlet 的可用參數，您可以執行 Get-Help Repair-WinGetPackageManager -Full。

如需 Windows 沙箱的詳細資訊 (包括如何安裝沙箱及其使用的預期內容)，請參閱 Windows 沙箱文件。

系統管理員考量

安裝程式行為可能會根據您是否以系統管理員權限執行 WinGet，而有所不同。

• 如果在沒有系統管理員權限的情況下執行 WinGet，則可能需要提供某些應用程式的權限才能安裝。 當安裝程式執行時，Windows 會提示您提高權限。 如果您選擇不提高權限，應用程式將無法安裝。

• 在系統管理員命令提示字元中執行 WinGet 時，您將不會看到應用程式需要的提高權限提示。 以系統管理員身分執行命令提示字元時，請務必小心，並且只安裝您信任的應用程式。

使用 WinGet

安裝應用程式安裝程式之後，您可以在命令提示字元中輸入 'WinGet' 來執行 WinGet。

其中一個最常見的使用案例是搜尋並安裝最愛的工具。

1. 若要搜尋工具，請輸入 winget search <appname>。

2. 確認您想要的工具可供使用之後，您就可以輸入 winget install <appname> 來安裝工具。 WinGet 工具會啟動安裝程式，並將應用程式安裝在您的電腦上。

3. 除了安裝和搜尋之外，WinGet 還提供一些其他命令，可讓您顯示應用程式的詳細資料、變更來源和驗證封裝。 如需完整的命令清單，請輸入：winget --help。

有些使用者回報了用戶端未在其 PATH 上的問題。

命令

目前的 WinGet 工具預覽版支援下列命令。

選項。

WinGet 工具支援下列選項。

支援的安裝程式格式

WinGet 工具支援下列類型的安裝程式：

• EXE (具有 Silent 和 SilentWithProgress 旗標)
• ZIP
• INNO
• NULLSOFT
• MSI
• WIX
• APPX
• MSIX
• BURN
• PORTABLE

以指令碼撰寫 WinGet

您可以使用下列語法，在單一命令中安裝多個應用程式。

USAGE: winget install <query1> <query2> ...

範例

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

偵錯和疑難排解

WinGet 提供記錄來協助診斷問題。 如需記錄的疑難排解和詳細資料，請參閱偵錯和疑難排解。

缺少工具

如果社群存放庫未包含您的工具或應用程式，請將套件提交至我們的存放庫。 新增您最愛的工具，以便您和其他人使用。

自訂 WinGet 設定

您可以藉由修改 settings.json 檔案來設定 WinGet 命令列體驗。 如需詳細資訊，請參閱https://aka.ms/winget-settings。 請注意，這些設定仍處於實驗階段，而且尚未完成該工具的預覽版本。

開放原始碼詳細資訊

WinGet 工具是 GitHub 存放庫 https://github.com/microsoft/winget-cli/ 中提供的開放原始碼軟體。 用於建立用戶端的原始碼位於 src 資料夾。

WinGet 的原始碼包含在 Visual Studio 2019 C++ 解決方案中。 若要正確建立解決方案，請安裝搭配 C++ 工作負載的 Visual Studio。

我們歡迎您參與撰寫 GitHub 上的 WinGet 原始碼。 您必須先同意並簽署 Microsoft CLA。

疑難排解

WinGet-cli 存放庫維護常見問題和常見錯誤的清單，以及如何解決的相關建議：

• 常見問題 -- 無法辨識、無法執行、應用程式安裝程式版本或 PATH 變數需要更新
• 常見錯誤 -- 錯誤 0x801901a0、0x80d03002、0x80070490