WinUI 3是微软为Windows平台打造的现代UI框架，基于C#开发可以充分利用.NET生态的优势，构建高性能、界面美观的原生桌面应用。要开始一个WinUI 3项目，首先需要完成开发环境的配置。
开发环境准备
开发WinUI 3项目需要满足以下环境要求：
- 操作系统：Windows 10 版本 1809 及以上，或者 Windows 11
- 开发工具：Visual Studio 2022 17.0 及以上版本
- 必备工作负载：在安装Visual Studio时需要勾选通用Windows平台开发和.NET桌面开发两个工作负载
- 额外组件：在单个组件列表中勾选Windows 10 SDK (10.0.19041.0)及以上版本，以及WinUI 3 模板相关组件
创建WinUI 3项目步骤
1. 打开项目创建向导
启动Visual Studio 2022，在起始页面点击创建新项目，进入项目模板选择界面。
2. 选择WinUI 3项目模板
在搜索框输入WinUI，会筛选出所有WinUI相关的项目模板，选择空白应用（WinUI 3 桌面版）模板，点击下一步。
3. 配置项目基本信息
在配置页面填写项目名称、选择项目存储路径，根据需要勾选将解决方案和项目放在同一目录中，点击创建即可生成初始项目。
项目结构说明
生成的WinUI 3项目默认包含以下核心文件：
| 文件/文件夹 | 作用说明 |
|---|---|
| App.xaml | 应用的全局资源配置和启动逻辑入口 |
| MainWindow.xaml | 应用主窗口的界面布局文件 |
| MainWindow.xaml.cs | 主窗口的后台逻辑代码文件 |
| Package.appxmanifest | 应用的清单文件，配置应用权限、入口等信息 |
编写第一个界面示例
我们可以修改MainWindow.xaml文件，添加一个简单的文本和按钮控件，代码如下：
<Window
x:Class="WinUI3Demo.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:WinUI3Demo"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
Title="WinUI 3 示例应用">
<StackPanel Orientation="Vertical" HorizontalAlignment="Center" VerticalAlignment="Center" Spacing="20">
<TextBlock x:Name="HelloText" Text="Hello WinUI 3" FontSize="24" />
<Button Content="点击修改文本" Click="Button_Click" />
</StackPanel>
</Window>
然后在MainWindow.xaml.cs中添加按钮的点击事件逻辑：
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
namespace WinUI3Demo
{
public sealed partial class MainWindow : Window
{
public MainWindow()
{
this.InitializeComponent();
}
private void Button_Click(object sender, RoutedEventArgs e)
{
// 点击按钮后修改文本块的内容
HelloText.Text = "你点击了按钮";
}
}
}
运行项目
点击Visual Studio顶部的启动按钮，或者按下F5快捷键，即可编译并运行项目。如果环境配置正确，会弹出应用窗口，点击窗口中的按钮，文本内容会发生变化，说明项目运行正常。
常见问题说明
- 如果创建项目时没有WinUI 3模板，需要检查是否安装了对应的单个组件，或者更新Visual Studio到最新版本
- 运行时提示SDK版本不匹配，需要安装项目要求的Windows 10 SDK版本
- WinUI 3项目默认是打包应用，如果需要非打包的桌面应用，可以在创建项目时选择对应的非打包模板