WinUI 3 是原生的 Windows 桌面應用程式架構。 它是 Windows 應用程式 SDK 的一部分——這是一組獨立於 Windows 作業系統本身的 API 和工具，必須安裝在目標機器上或與你的應用程式一起打包。 WinUI 3 支援 C# 與 C++，並非跨平台或網頁框架。
Important
WinUI 3 與 UWP 是不同的。 WinUI 3 使用命名 Microsoft.UI.Xaml 空間，並作為桌面程序執行;UWP 使用 Windows.UI.Xaml 並執行於應用程式容器中。 WinUI 3 支援封裝（MSIX）、帶有外部位置的封裝，以及非封裝發行版——選擇合適的方案取決於你的部署情境。 請參閱 「選擇分配方式 」以獲得指引。
選擇你的路徑
有兩種支援的路徑可用於建立 WinUI 3 專案。
| Visual Studio | 命令列 | |
|---|---|---|
| 適用對象 | 對於剛接觸 Windows 開發的新手、視覺化 UI 設計師，或任何想要完整 IDE 體驗的人 | 熟悉終端機、CI/CD 管線或腳本化環境設定的開發者 |
| 工具 | 已安裝 Windows 應用程式 SDK 和 WinUI 工作負載的 Visual Studio 2026 | .NET 10 SDK 搭配dotnet newWinUI 範本 |
| 專案建立 | 新增專案精靈 — 選取 空白應用程式，已封裝（桌面版中的 WinUI 3） 範本 | dotnet new winui -n MyApp |
| 建造與運行 | 按 F5 — Visual Studio 會建置、簽署、部署 MSIX 套件，並啟動應用程式 |
dotnet run — 以套件身份建置並啟動應用程式（需開發者模式） |
| Debugging | 完整的 Visual Studio 除錯器，支援 XAML 即時預覽 | 手動附加除錯器，或在 Visual Studio 中開啟產生的 .sln |
這兩條路徑都會產生等效的 WinUI 3 專案。 Visual Studio 路徑會自動處理 MSIX 簽名與部署。 命令列路徑在本機開發時使用 dotnet run（隨附的 Microsoft.Windows.SDK.BuildTools.WinApp 套件會自動處理偵錯身分識別）；若要封裝以供散發，則需要額外步驟。
先決條件
這兩條路徑的最低要求相同。
- 建議使用 Windows 10 版本 1809（版本 17763）或更新版本 — 建議使用 Windows 11
- 裝置已啟用開發者模式（
ms-settings:developers） - Visual Studio 2026（Visual Studio 路徑）或 .NET 10 SDK（命令列路徑）
Windows 應用程式 SDK 是獨立於 Windows 的安裝。 Visual Studio 會把它安裝在工作負載設定中。 對於命令列路徑，範本 dotnet new winui 會自動導入所需的 NuGet 套件。
