wpf 的核心难点在于数据驱动机制、依赖属性生命周期和资源作用域等隐性规则，而非简单控件拖拽；必须选 wpf app (.net) 模板、实现 inotifypropertychanged、正确管理资源字典顺序、并在 ui 线程操作集合。
INotifyPropertyChanged 不触发绑定、Dispatcher 线程崩掉、样式资源找不到这三类坑，基本不算真正用过 WPF。
创建项目时选错模板会导致后续所有绑定都“看起来正常但不工作”
Visual Studio 新建项目时，必须选 WPF App (.NET)（注意后缀是 .NET，不是 .NET Framework）。如果误选了 WPF App (.NET Framework)，虽然代码能编译，但你将无法使用 Microsoft.Extensions.DependencyInjection 原生集成、ObservableCollection<t></t> 的现代通知行为可能异常，且 NuGet 包版本会受限。
实操建议：
- 新建项目 → 搜索 “wpf” → 选图标带蓝色“.NET”字样的那个，不是带“Framework”的
- 检查生成的
.csproj文件里是否包含<targetframework>net8.0-windows</targetframework>（或 net9.0）这类标识 - 不要手动修改
UseWPF属性为true来“硬凑”WPF 支持——它只对 SDK 风格项目有效，且需配套WindowsBase引用
绑定数据前，必须让 DataContext 和 INotifyPropertyChanged 同时就位
写完 public string Name { get; set; } 然后绑到 {Binding Name} 却发现改属性 UI 就不更新？这不是 XAML 写错了，是根本没启用变更通知机制。
常见错误现象：
- 属性赋值后界面不动，调试器里确认值已变
-
PropertyChanged事件始终为 null - 用了
SetProperty(ref _name, value)但基类没实现INotifyPropertyChanged
正确做法：
- ViewModel 类必须显式实现
INotifyPropertyChanged - 每个可绑定属性都要调用
OnPropertyChanged()，不能只靠自动属性 -
DataContext要在 XAML 或代码中明确指定，比如this.DataContext = new MainViewModel(); - 推荐用
CommunityToolkit.Mvvm的[ObservableProperty]自动生成，避免手写样板
资源字典合并顺序错一位，整个主题就“失效”
把 Brushes.xaml 和 Buttons.xaml 都放进 App.xaml 的 MergedDictionaries，结果按钮颜色还是默认灰？问题往往出在加载顺序：后加载的资源会覆盖前面同 key 的定义，但更隐蔽的是——如果 Buttons.xaml 里用了 {StaticResource PrimaryBrush}，而 PrimaryBrush 定义在 Brushes.xaml 里，那 Brushes.xaml 必须排在 Buttons.xaml 前面。
实操要点：
- 打开
App.xaml，检查MergedDictionaries中Source的顺序 - 所有被引用的资源（如 Brush、Style、Template）必须先声明，再被引用
- 避免在 UserControl 或 Window 级别重复定义全局资源，容易造成作用域冲突
- 调试技巧：在 XAML 编辑器里按 Ctrl+Click 跳转资源，若跳不到，说明路径错或未加载
在非 UI 线程更新集合时，直接 Add() 会抛 InvalidOperationException: The calling thread cannot access this object
后台任务下载完数据，想往 ObservableCollection<item></item> 里加几条，结果一加就崩——这不是集合本身的问题，是 WPF 的 UI 元素（包括 ObservableCollection 的通知逻辑）只能由创建它的线程（即 Dispatcher 线程）访问。
解决方式只有两种：
- 用
Dispatcher.InvokeAsync(() => Items.Add(item))把操作切回 UI 线程 - 换用线程安全的替代方案，比如
CommunityToolkit.Mvvm提供的ObservableRecipient+WeakReferenceMessenger发消息，由 UI 线程订阅处理 - 绝对不要用
Items.ToList().ForEach(...)绕过——只是把崩的时间点延后了
StaticResource 查找失败是编译期静默忽略，DynamicResource 找不到才报错；又比如 UpdateSourceTrigger=PropertyChanged 对 TextBox 默认关闭，要手动开。这些细节不亲手调一次断点、不看一眼输出窗口的 Binding 表达式错误，光看教程永远意识不到。
