WinGet 是一個命令列工具，讓使用者能在 Windows 10、Windows 11 及 Windows Server 2025 電腦上發現、install升級、移除及配置應用程式。 這個工具是Windows 封裝管理員服務的用戶端介面。
安裝 WinGet
WinGet Windows 封裝管理員 可於 Windows 11、現代版本的 Windows 10，以及 Windows Server 2025 年版中作為 App Installer 的一部分提供。 App 安裝程式是由 Microsoft 商店在 Windows 桌面版本中提供並更新的系統元件，並於 Windows Server 2025 上透過更新來提供。
注意
WinGet 命令列工具僅支援於 1809 版本（建檔 17763）或更新版本Windows 10。 WinGet 只有在你第一次以使用者身份登入 Windows 後才會啟用，這會觸發Microsoft Store將Windows 封裝管理員註冊為非同步程序的一部分。 如果你最近第一次以使用者身份登入，發現 WinGet 還沒開放，你可以打開 PowerShell 並輸入以下指令來請求這個 WinGet 註冊：Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe。
注意
有可能你的裝置上沒有安裝 App Installer 。 如果是這樣，可以 在這裡下載。
安裝 WinGet 預覽版本 [僅限開發人員]
WinGet 包含在應用程式安裝程式中。 若要嘗試最新版 Windows 封裝管理員 的功能，您可以透過下列其中一種方式 install 預覽組建：
下載最新的 WinGet 預覽版本。 閱讀 WinGet 預覽的版本資訊，以瞭解任何新功能。 安裝此套件後，會獲得 WinGet 客戶端的預覽版本，但無法自動更新 Microsoft Store 的新預覽版本。
使用 Microsoft 帳號（MSA）、工作、學校或 Microsoft Entra ID（前稱 Azure Active Directory）帳號，在 Canary 或 Dev 頻道註冊 Windows 測試人員計畫。 Windows Insider 的 Canary 與 Dev 頻道將包含來自 Microsoft Store 的 WinGet 新預覽版自動更新。
在 Windows 沙盒安裝 WinGet
Windows Sandbox 提供輕量級桌面環境，讓應用程式能安全地獨立運行。 安裝在 Windows 沙盒環境中的軟體仍保持「沙盒」狀態，並與主機分開執行。 Windows Sandbox 不包含 WinGet，也不包含 Microsoft Store 應用程式，因此你需要從 GitHub 的 WinGet 發佈頁面下載最新的 WinGet 套件，或使用 Repair-WinGetPackageManager 指令碼。
要在 install 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 -AllUsers
Write-Host "Done."
若要在機器範圍內 install WinGet PowerShell 模組，您可以搭配 Install-Module Cmdlet 使用 -Scope AllUsers 參數。 如果你想要預覽版的 WinGet，可以用 cmdlet 加入 -IncludePrerelease 參數 Repair-WinGetPackageManager 。 要查看 cmdlet 可用的參數 Repair-WinGetPackageManager ，你可以執行 Get-Help Repair-WinGetPackageManager -Full。
想了解更多關於 Windows 沙盒的資訊，包括如何建立install沙盒以及使用中可以期待什麼，請參閱 Windows 沙盒文件。
管理員注意事項
安裝程式行為可能會根據您是否以系統管理員權限執行 WinGet，而有所不同。
當無管理員權限執行 WinGet 時，某些應用程式 可能需要提升 至 install。 安裝程式執行時，Windows 會提示你需要提升權限。 如果你選擇不提升，應用程式將無法升 install高。
在系統管理員命令提示字元中執行 WinGet 時，您將不會看到應用程式需要的提高權限提示。 以管理員身份執行命令提示字元時，務必謹慎，且只使用 install 你信任的應用程式。
使用 WinGet
安裝 App Installer 後，你可以從命令提示字元輸入 '' 來執行 winget。
最常見的使用情境之一，是為了 search 並將 install 設為喜愛的工具。
若要對工具search，請輸入
winget search <appname>。確認所需工具可用後，輸入 install
winget install <appname>。 WinGet 工具會在你的電腦上啟動安裝程式和install應用程式。
除了 install 和 search之外， WinGet 還提供多種指令，讓你能 顯示應用程式細節 、 變更原始碼及 驗證套件。 如需完整的命令清單，請輸入：
winget --help。
有些使用者回報了在 PATH 中找不到客戶端程式的問題。
命令
目前版本的 WinGet 工具支援以下指令。
| 指令 | 描述 |
|---|---|
| install | 安裝指定的應用程式。 |
| show | 顯示指定應用程式的詳細資料。 |
| 源 | 新增、編輯、移除及更新由 WinGet 存取的Windows 封裝管理員儲存庫。 |
| search | 搜尋應用程式。 |
| list | 顯示已安裝的套件。 |
| 升級 | 升級指定的應用程式。 |
| 解除安裝 | 卸載指定的應用程式。 |
| 哈希 | 產生安裝程式的 SHA256 雜湊。 |
| 驗證 | 驗證提交至 Windows 封裝管理員 倉庫的清單檔案。 |
| settings | 打開 settings。 |
| 功能 | 顯示實驗性功能的狀態。 |
| export | 匯出已安裝套件的清單。 |
| import | 安裝檔案中的所有套件。 |
| pin | 管理套件鎖定。 |
| configure | 將系統設定為所需的狀態。 |
| 下載 | 下載指定的應用程式安裝程式。 |
| repair | 修復選取的應用程式。 |
| dscv3 | PowerShell Desired State Configuration （DSC） v3 資源指令。 |
選項
WinGet 工具支援下列選項。
| 選項 | 描述 |
|---|---|
| -v， --version | 傳回 WinGet 的目前版本。 |
| --info | 為您提供有關 WinGet 的所有詳細資訊 (包括授權、隱私權聲明和已設定群組原則的連結)。 |
| -?, --help | 顯示 WinGet 的額外 help 內容。 |
| --wait | 提示用戶在結束之前按下任何按鍵。 |
| --logs,--open-logs | 開啟預設記錄位置。 |
| --verbose,--verbose-logs | 啟用 winget 的詳細記錄。 |
| --nowarn,--ignore-warnings | 隱藏警告輸出。 |
| --disable-interactivity | 停用互動式提示。 |
| --proxy | 設定要用於此運行的代理。 |
| --no-proxy | 停用此次執行的代理伺服器使用。 |
支援的安裝程式格式
WinGet 支援下列型態的安裝程式：
- EXE (具有 Silent 和 SilentWithProgress 旗標)
- 郵遞區號
- INNO
- NULLSOFT
- MSI
- WIX
- appx
- MSIX
- 燒
- 便攜式
- 字體
以指令碼撰寫 WinGet
Microsoft。WinGet.Client PowerShell 模組可在 PowerShell 資源庫 上取得。
偵錯和疑難排解
WinGet 提供日誌功能以診斷 help 問題。 如需疑難排解和日誌記錄的詳細資料，請參閱偵錯與疑難排解。
缺少工具
如果 社群存放庫 不包含您的工具或應用程式，請將套件提交至我們的 存放庫。 新增您最愛的工具，以便您和其他人使用。
自訂 WinGet settings
你可以透過修改 settings 檔案來設定 WinGet 命令列體驗。 欲了解更多資訊，請參閱該 settings 指令頁面。
開放原始碼詳細資訊
WinGet 工具是可在 GitHub 的https://github.com/microsoft/winget-cli/倉庫中獲得的開源軟體。 用於建立用戶端的原始碼位於 src 資料夾。
WinGet 的原始碼包含於 2022 Visual Studio C++ 解決方案中。 若要正確建置解決方案，請複製存放庫並執行位於 「.github」 目錄中的適當 WinGet 組態檔。
我們鼓勵你為GitHub上的WinGet來源貢獻意見。 您必須先同意並簽署 Microsoft CLA。 您的拉取請求應該來自您自己fork中的分支。
疑難排解
winget-cli 倉庫維護一份常見問題與錯誤清單，並提供解決建議：
