快速入门：设置环境并创建 WinUI 3 project

本快速入门指南将指导你设置 WinUI 和Windows App SDK开发环境并创建第一个应用。 若要详细了解 Visual Studio 及其模板支持 WinUI 开发，请参阅Visual Studio概述。 若要开发 WinUI 应用，需要：

• Visual Studio 2026 配备 WinUI 和 Windows App SDK 所需的工作负载
• 在设备上启用开发人员模式

设置开发环境

WinGet 配置

打开 Windows Terminal 并在 PowerShell 中运行以下命令，以使用 WinGet 配置文件1 自动设置环境。 这将：

• 使用所需的工作负载安装 Visual Studio 2026
• 启用“开发人员模式”

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

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

手动安装

启用“开发人员模式”

Windows包括开发模式，用于调整安全设置，以便运行和测试要生成的应用。 使用 Visual Studio 生成、部署和测试应用之前启用开发人员模式。

若要启用开发人员模式，请执行以下操作：

• 打开Windows设置并导航到 System > Advanced 页。
• 将 开发人员模式 开关切换为 “开” ，并在确认对话框中确认你的选择。

安装Visual Studio和所需的 WinUI 和Windows App SDK工作负载

使用以下链接下载并安装最新的Visual Studio。 有关详细信息，请参阅 Install Visual Studio。

Download Visual Studio

所需的工作负载和组件

在Visual Studio安装程序中，在 Workloads 选项卡上选择以下工作负荷。如果已安装Visual Studio，请打开安装程序，然后选择 Modify添加它们。

• 使用Windows App SDK对于 C# 应用开发，请选择 WinUI 应用程序开发。

• 对于C++应用开发，请在“安装详细信息”窗格中的“WinUI 应用程序开发”节点下选择C++ WinUI 应用开发工具（这还将选择任何其他必需的组件）。

创建并启动第一个 WinUI 应用

1. 打开Visual Studio并选择创建一个新项目。

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

   

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

   

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

   

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

   

   你已生成并启动第一个 WinUI 应用！ 🎉

后续步骤

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

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

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