WinUI 3怎么开发桌面应用 WinUI 3项目创建与入门教程

来源:这里教程网 时间:2026-02-21 17:37:08 作者:

立即进入☞☞☞☞☞各种好用的网站☜☜☜☜☜”;

立即进入☞☞☞☞☞办公资源大全直接保存☜☜☜☜☜”;

WinUI 3怎么开发桌面应用 WinUI 3项目创建与入门教程 - php中文网

WinUI 3 开发桌面应用,核心是用 Windows App SDK 构建 .NET 桌面程序(非 UWP),界面用 WinUI 3 控件,打包为 MSIX。它不依赖商店,能直接安装运行,适配 Windows 10 1809+ 和 Windows 11。

开发环境准备

确保三件事到位:

启用 Windows 开发者模式:设置 → 系统 → 关于 → 隐私与安全 → 开发人员选项 → 开发者模式(打开) 安装 Visual Studio 2022(推荐最新稳定版),安装时勾选: “.NET 桌面开发” 工作负载(含 Windows 应用 SDK 支持) “通用 Windows 平台开发” 工作负载(可选,但建议勾上,部分模板和工具依赖它) 确认已安装 Windows App SDK:VS 安装器通常自动带入;也可手动通过 扩展 → 管理扩展 → 搜索 “Windows App SDK” 更新到最新稳定版(如 1.5 或 1.6)

创建第一个 WinUI 3 桌面项目

关键点:选对模板,避免混淆 UWP 或旧版 Project Reunion。

打开 Visual Studio → “创建新项目” 搜索框输入 “WinUI”,或在筛选器中选择 语言=C#、平台=Windows、项目类型=WinUI 选择模板:“Blank App, Packaged (WinUI 3 in Desktop)”(注意名称里有 “Packaged” 和 “in Desktop”) 命名项目(如 MyDesktopApp)、选择路径,点击创建 弹出窗口中设置目标 Windows 版本(建议默认,如 Windows 11 22H2),最低版本保持 ≥10.0.17763(即 1809)

生成后,解决方案里会看到两个项目:一个是你写代码的 桌面应用项目(含 MainWindow.xaml),另一个是自动生成的 MSIX 打包项目(用于生成安装包)。

项目结构与入门代码

主要文件都在桌面项目中:

App.xaml / App.xaml.cs:应用生命周期入口,继承自
Microsoft.UI.Xaml.Application
MainWindow.xaml / MainWindow.xaml.cs:主窗口 UI 和逻辑,初始是一个居中按钮 按钮点击事件已预置:
Click="myButton_Click"
,后台方法里改文本即可验证

例如在

MainWindow.xaml.cs
中:

private void myButton_Click(object sender, RoutedEventArgs e)
{
    myButton.Content = "已点击!";
}

F5 运行,就能看到窗口和响应效果。不需要额外配置,XAML 和 C# 联动开箱即用。

添加页面与简单导航

WinUI 3 桌面应用默认没有 NavigationView,但支持页面跳转:

右键桌面项目 → 添加 → 新建文件夹 → 命名为 Pages 右键 Pages 文件夹 → 添加 → 新项 → 选择 “Blank Page (WinUI 3)” → 命名为
Page1.xaml
MainWindow.xaml.cs
中添加导航代码(需先引用命名空间):

using Microsoft.UI.Xaml.Controls;
private void myButton_Click(object sender, RoutedEventArgs e)
{
    this.Content = new Page1();
}

这样点击按钮就切换到新页面。更规范的做法是使用

Frame
+
NavigationService
,但起步阶段直接替换 Content 已足够直观。

基本上就这些。后续可逐步加入 NavigationView、数据绑定、Fluent 设计元素(Acrylic、Reveal)、自定义控件等。不复杂但容易忽略的是:始终用“Packaged (Desktop)”模板、别选错最低系统版本、记得开开发者模式——这三点卡住新手最多。

相关推荐