WPF项目需选对.NET版本并确保XAML与C#类名一致。应选用.NET 8/9的现代模板，检查.csproj中TargetFramework为net8.0-windows；x:Class、命名空间、类声明及App.xaml的StartupUri须同步；partial不可删；事件处理宜轻量转发至ViewModel。
WPF 项目能跑起来，不等于你真懂它怎么组织、怎么改、怎么加功能——很多卡点其实在创建那一刻就埋下了。
Visual Studio 创建 WPF 项目时必须选对的 .NET 版本
选错框架版本会导致后续控件不可用、绑定失效、甚至 App.xaml 编译报错。.NET 6+（尤其是 .NET 8/9）是当前推荐目标，但要注意：WPF Application (.NET Framework) 模板已过时，不能选；WPF Application（无后缀）才是现代模板。
- 如果你在“新建项目”里看到两个都叫“WPF 应用程序”，带
(.NET Framework)的那个跳过——它默认用 .NET Framework 4.7.2，不支持Microsoft.Extensions.DependencyInjection等现代特性 - 新建时在“Additional information”页明确选择
.NET 8.0 (Long-term support)或更高，避免后期手动升级引发TargetFramework冲突 - 项目生成后立刻检查
.csproj文件第一行是否为<TargetFramework>net8.0-windows</TargetFramework>，不是的话要手动改，否则Windows-specific API（如System.Windows.Forms互操作）会标红
MainWindow.xaml 和后台代码之间的绑定关系不是自动“猜出来”的
很多人改了 MainWindow.xaml 的 x:Class 值或类名，却忘了同步改 MainWindow.xaml.cs 的命名空间和类声明，结果启动就抛 XamlParseException，错误信息里根本没提“类名不匹配”。
-
MainWindow.xaml顶部必须和MainWindow.xaml.cs完全一致：x:Class="MyApp.MainWindow"→namespace MyApp { public partial class MainWindow : Window { ... } } - 如果重命名了窗口类（比如改成
MainView），除了改两处声明，还要进App.xaml把StartupUri="MainWindow.xaml"改成StartupUri="MainView.xaml"，否则程序启动直接黑屏 -
partial关键字不能删——它是让 XAML 和 C# 代码能合并成一个类的关键，删了会报does not contain a definition for InitializeComponent
添加控件后事件处理写在哪、怎么注册，直接影响可维护性
双击设计器里的按钮自动生成事件处理方法，看似省事，但容易把逻辑全塞进 MainWindow.xaml.cs，导致后期无法测试、难以复用。
- 推荐写法：在 XAML 中用
Click="PlayButton_Click"显式绑定，然后在.xaml.cs里只留轻量级转发，比如ViewModel?.PlayCommand.Execute(null); - 如果坚持用代码写事件，别用
button.Click += new RoutedEventHandler(...)这种老式委托写法——WPF 路由事件推荐用RoutedEventHandler或 lambda，但注意 lambda 可能造成内存泄漏（没手动-=解绑） - 控件名不要用
button1、textBox2这类默认名，XAML 中立即设x:Name="PlayButton"，C# 里才能用this.PlayButton直接访问，否则得靠FindName查找，效率低还易空引用
真正容易被忽略的，是 App.xaml 里那行 StartupUri ——它不像 Main() 那么显眼，但一旦指向不存在的 XAML 文件，程序连异常都不会抛，静默退出。
