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

创建、生成并运行第一个 WinUI 3 应用。 选择Visual Studio，获取具有可视化设计器支持的完整 IDE 体验，或者从任何编辑器中的命令行使用 dotnet new。 使用下面的选项卡在两种方法之间切换。

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安装程序中，选择“工作负荷”选项卡上的 WinUI 应用程序开发工作负载。对于 C++ 开发，请在“安装详细信息”窗格中选择该工作负载下的 C++ WinUI 应用开发工具。

   

小窍门

如果在安装Visual Studio后看不到 WinUI 模板，请打开Visual Studio安装程序，选择 Modify，并确认已检查 WinUI 应用程序开发工作负荷。 修改安装后重启Visual Studio。

创建并启动第一个 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 应用！ 🎉

后续步骤

生成第一个 WinUI 应用
准备好更进一步了？ 按照分步教程生成完整的 WinUI 应用。

WinUI 3 画廊
浏览 WinUI 控件、特性和功能的交互式示例。

示例和资源
浏览代码示例、初学者项目和工具，以加速开发。