选对wpf模板和.net版本是项目正常运行的前提：必须使用无后缀的“wpf application”模板（基于microsoft.net.sdk.wpf sdk，支持net10.0-windows等新特性），而非带(.net framework)后缀的传统模板；新建后须验证targetframework、x:class与类声明一致性、startupuri指向正确xaml文件；设计器打不开需检查工作负载安装及项目路径是否含中文或空格；事件处理应轻量转发至viewmodel，绑定须用observablecollection并确保datacontext和属性名准确。

选对模板和.NET版本，WPF项目才能真正跑起来——不是“编译通过”，而是设计器能打开、绑定不静默失败、控件能用新API。

Visual Studio 新建项目时必须避开的两个模板

你看到的两个都叫“WPF 应用程序”的选项，底层完全不兼容：

• 带 (.NET Framework) 后缀的那个，用的是 .NET Framework 4.8 或更老版本，csproj 是传统格式，Microsoft.Extensions.DependencyInjection 这类现代特性直接不可用
• 无后缀的“WPF Application”才是正确入口，它默认使用 Microsoft.NET.Sdk.Wpf SDK 风格项目，支持 net10.0-windows、InkCanvas.StylusPlugIns、XAML 热重载等现代能力
• 如果误选了旧模板，后续升级不是改个 TargetFramework 就行——要重写项目文件、迁移命名空间前缀（比如从 xmlns:local="clr-namespace:" 改为自动解析）、修复所有 NuGet 引用路径

创建后立刻验证的三处关键配置

项目生成完别急着写代码，先确认这三点是否全部对齐：

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

• 打开 .csproj 文件，第一行必须是 <targetframework>net10.0-windows</targetframework>（或 net9.0-windows），不是 net8.0 也不是 net48
• MainWindow.xaml 顶部的 x:Class 值（如 MyApp.MainWindow）必须和 MainWindow.xaml.cs 中的命名空间 + 类声明完全一致，包括大小写
• App.xaml 里的 StartupUri 必须指向真实存在的 XAML 文件名，比如你把窗口重命名为 MainView.xaml，就得同步改成 StartupUri="MainView.xaml"
• partial 关键字不能删——它是让 XAML 和 C# 合并成一个类的唯一机制，删了会报 does not contain a definition for InitializeComponent

设计器打不开？先查工作负载和路径

双击 MainWindow.xaml 只显示空白或报错，大概率不是代码问题，而是环境没配好：

• 确认 Visual Studio 已安装 .NET desktop development 工作负载——只装了 .NET 10 SDK 不够，缺少 WpfCoreDesigner 进程支持
• 项目保存路径不能含中文或空格，比如 C:\Users\张三\source\repos 或 C:\My Projects\ 都会导致设计器加载失败，错误信息常是模糊的 XamlParseException
• 如果仍不显示，右键 MainWindow.xaml → “查看代码”，在构造函数第一行手动补上 InitializeComponent();（模板本该自动生成，但偶尔漏写）

事件处理别塞进 MainWindow.xaml.cs

双击按钮自动生成 Click="Button_Click" 看似方便，但很快会让 MainWindow.xaml.cs 变成逻辑泥潭：

• 所有业务逻辑堆在里面，无法单元测试，复用困难，改一个功能牵动全局
• 推荐做法：XAML 中保留 Click="PlayButton_Click"，但在方法体内只做轻量转发，例如 ViewModel?.PlayCommand.Execute(null);
• 真正逻辑放在 ViewModel 层，配合 INotifyPropertyChanged 和 ObservableCollection<t></t> 实现响应式更新，而不是靠 TextBox.Text = "xxx" 手动刷 UI
• 绑定集合时务必用 ObservableCollection<string></string>，不是 List<string></string>；绑定属性必须实现通知接口，否则界面不会随数据变

最易被忽略的点是资源路径和绑定上下文：XAML 里写 {Binding UserName}，但 ViewModel 没设为 DataContext，或者属性名拼错一个字母，界面就静默空白——没有编译错误，也没有运行时异常，只有日志里一句不起眼的绑定失败提示。