应首先选择正确的项目模板,windows桌面开发有winforms、wpf、winui三条互不兼容的技术路线;创建时须在visual studio中准确匹配语言(c#)、平台(windows)、项目类型及目标框架(如.net 8),并提前安装对应工作负载(如.net桌面开发或winui应用程序开发),否则将导致模板缺失、引用错误或部署失败。

从创建正确的项目模板开始,而不是先写代码或拖控件。
选错项目类型会导致后续全部重来
Windows 桌面软件在 Visual Studio 里有三种主流技术路线:Windows Forms、WPF、WinUI(Windows 应用 SDK)。它们不兼容,不能混用,也不能靠改配置互相转换。
-
Windows 窗体应用 (.NET Framework)和Windows 窗体应用(.NET 6+)是两套不同模板,前者绑定旧版 .NET Framework,后者基于现代 .NET,运行时依赖不同 -
WPF 应用程序使用 XAML + C#,适合需要复杂动画、数据绑定或高 DPI 适配的桌面程序,但不支持 WinUI 的新控件和 Windows 11 原生样式 -
WinUI 空白应用 (打包)是当前微软主推的桌面 UI 方案,仅支持 Windows 10/11,需启用开发者模式,发布必须走 MSIX 或 App Installer
新手最容易踩的坑:看到“Windows 窗体”就点,结果装完发现目标机器没装 .NET Framework;或者选了 WinUI 却卡在签名/部署环节——因为没提前装 WinUI 应用程序开发 工作负载。
安装阶段必须勾选对应工作负载
Visual Studio 安装器里没有“C# 全能包”,每个桌面框架都得单独勾选,漏一个就创建不了项目。
- 做 Windows Forms(.NET 6+)→ 必须勾选
.NET 桌面开发 - 做 WPF → 同样依赖
.NET 桌面开发,但不需要额外组件 - 做 WinUI → 必须勾选
WinUI 应用程序开发,且推荐同时勾选Universal Windows Platform 开发(部分工具链共享)
如果创建项目时搜不到模板,别反复刷新,直接打开 工具 > 获取工具和功能 补装。搜索框里输 “winui” 或 “desktop” 比翻分类快得多。
新建项目时关键三步不能跳
不是点“创建新项目”就完事,中间三个筛选动作决定你后面一周能不能跑起来。
- 语言选
C#,平台选Windows,项目类型按实际需求选Windows 窗体应用/WPF 应用程序/WinUI 空白应用 (打包) - 项目名称不要含空格或中文,比如
HelloWorld可以,我的第一个程序会触发生成路径异常 - 目标框架务必确认:.NET 8 和 .NET 9 是当前主流,
.NET Framework 4.8已停止更新,新项目不建议选
创建完成后,立刻检查解决方案资源管理器里是否出现 MainWindow.xaml(WPF/WinUI)或 Form1.cs(Windows Forms)。如果没有,说明模板加载失败,别急着写代码,先删项目重来。
真正卡住人的地方从来不是“怎么写按钮点击事件”,而是项目一开就缺引用、设计器打不开、生成时报 MSB3644 或 NU1102——这些几乎全源于初始模板和工作负载没对齐。










