快速開始：建立你的第一個 WinUI 3 應用程式

建立、建置並執行你的第一個 WinUI 3 應用程式。 選擇 Visual Studio 以獲得完整的 IDE 體驗並支援視覺設計器，或是 dotnet 新手，能在任何編輯器中從命令列操作。 請使用下方的分頁在兩種方式間切換。

Visual Studio

設定開發環境

要用 Visual Studio 開發 WinUI 3 應用程式，你需要 Visual Studio 2026，並啟用所需的工作負載並啟用開發者模式。

使用 WinGet 設定（推薦）

打開 Windows 終端機，並在 PowerShell 中執行以下指令，即可自動安裝具備所需工作負載的 Visual Studio 2026，並使用 WinGet 設定檔啟用開發者模式：

winget configure -f https://aka.ms/winui-config

想查看設定檔並了解更多，請參考 GitHub 上的 README。

備註

如果您的環境中無法使用 WinGet，請先安裝：

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

更多資訊請參閱 使用 WinGet 。

手動設定

如果你偏好手動安裝工具：

1. 啟用開發者模式：打開 Windows 設定，進入系統>進階，並將開發者模式切換為開啟。

2. 下載並安裝 Visual Studio 2026。 詳情請參見 Install Visual Studio。

3. 在 Visual Studio 安裝程式中，選擇 Workloads 標籤中的 WinUI 應用程式開發工作負載。對於 C++ 開發，也可以在安裝細節欄目中選擇該工作負載下的 C++ WinUI 應用程式開發工具。

   

小提示

如果安裝後沒有看到 WinUI 範本，請打開Visual Studio Visual Studio安裝程式，選擇 Modify，確認 WinUI 應用程式開發工作負載已勾選。 修改安裝後重新啟動 Visual Studio。

建立並啟動你的第一個 WinUI 3 應用程式

1. 打開 Visual Studio 2026，選擇建立新專案。

2. 搜尋 WinUI，選擇 WinUI Blank App （Packaged） C# project 範本，然後選擇 Next。

   

3. 輸入專案名稱並選擇 「建立」。

   

4. 按下 開始 鍵（F5）來建立並執行你的應用程式。

   

   你的應用程式以除錯模式建置、部署並啟動：

   Hello World專案已建置並執行

   你已經建立並啟動了你的第一個 WinUI 3 應用程式！ 🎉

命令列

先決條件

• Windows 10 版本 1809（版本 17763）或更新版本
• 啟用開發者模式（ms-settings:developers）
• .NET 10 SDK 或更新版本（可使用 dotnet --version 驗證）

建立並執行你的第一個 WinUI 3 應用程式

1. 安裝適用於 dotnet new 的 WinUI 3 專案範本（執行一次）：

   dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
   

2. 建立一個新專案並開始著手：

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. 建置專案：

   dotnet build
   

4. 執行應用程式：

   dotnet run
   

   該範本包含 Microsoft.Windows.SDK.BuildTools.WinApp，可掛鉤至 .NET CLI run 目標，註冊除錯身份並以 MSIX 套件身份啟動應用程式——無需手動部署步驟。

   一個空白的應用程式視窗會跳出。 你已經建立並啟動了你的第一個 WinUI 3 應用程式！ 🎉

後續步驟

打造你的第一個 WinUI 應用程式
準備好更進一步了嗎？ 請依照步驟教學打造完整的 WinUI 應用程式。

WinUI 3 圖庫
探索 WinUI 控制項、功能與互動範例。

範例與資源
瀏覽程式碼範例、入門專案與工具，加速你的開發。