快速入门：创建第一个 WinUI 3 应用

设置开发环境

若要开发具有Visual Studio的 WinUI 3 应用，需要Visual Studio 2026，并启用所需的工作负载和开发人员模式。

使用 WinGet 进行设置（建议）

打开Windows 终端并在 PowerShell 中运行以下命令，使用所需的工作负载自动安装 Visual Studio 2026，并使用 WinGet 配置文件启用开发人员模式：

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

若要查看配置文件并了解详细信息，请参阅GitHub上的README。

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

手动设置

如果希望手动安装工具：

1. 启用开发人员模式：打开Windows设置，导航到系统>高级，并将开发人员模式切换为“开”。

2. 下载并安装 Visual Studio 2026。 有关详细信息，请参阅 Install Visual Studio。

3. 在Visual Studio安装程序中，选择“工作负荷”选项卡上的 WinUI 应用程序开发工作负载。对于 C++ 开发，请在“安装详细信息”窗格中选择该工作负载下的 C++ WinUI 应用开发工具。

   

创建并启动第一个 WinUI 3 应用

1. 打开 Visual Studio 2026，然后选择“创建新项目”。

2. 搜索 WinUI，选择 WinUI 空白应用（打包） C# 项目模板，然后选择“ 下一步”。

   

3. 输入项目名称，然后选择“ 创建”。

   

4. 按 Start （F5） 生成并运行应用。

   

   应用在调试模式下生成、部署和启动：

   

   你已生成并启动第一个 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 应用！ 🎉